Questions about dtx, LaTeX self-documenting code system

learn more… | top users | synonyms

3
votes
1answer
28 views

SB@ in dtx and sty files

When reading several dtx files in order to write my own, I saw the command \SB@... in front of several other commands. What does it mean? I could not find reliable sources as explanation.
3
votes
0answers
21 views

Including compiled PDFs in documentation built by l3build

I am building a project with l3build. There are some examples I want to present in the documentation, showing their source code, annotated with DocStrip, as well as including the output they produce ...
3
votes
1answer
24 views

Creating csv files from .dtx: blank line at top

I'm working on a .dtx project in which I might embed data in the .dtx to be written to a couple of .csv files. The problem I'm encountering is that a line feed character is inserted before the first ...
1
vote
1answer
101 views

Generate .tex from .dtx

I have been trying to extract .tex code out of a .dtx file (this file to be precise, which should produce the microtype documentation). I understand the idea of having a single .dtx file from which ...
1
vote
1answer
16 views

README file creation from a dtx file

When I run my dtx file, I get a README file with all the information, but there are no (apparent) line feeds in it. If I look at it with Notepad, everything is strung along with no line breaks at ...
1
vote
0answers
41 views

Error when installing DTX submode macro on WinEdt [closed]

I'm running WinEdt 9 Build: 20150713 (v. 9.1) - 64-bit on Windows 7 and am attempting to install the DTX submode. I see that the addOrUpdate macro and the dynamicKeywords package need to be installed ...
2
votes
0answers
60 views

Using .cls macros in the typesetting of the .dtx from which .cls is generated

I read some advice suggesting that when writing a package, one should use that package in one's dtx file in order to demonstrate the use of macros and environments. Presumably, the same should be true ...
5
votes
1answer
39 views

Can I mark an internal function or variable as 'not documented' in l3doc?

There are several internal variables I use that I do not see a need to document in the user-interface section, but I want to explain in the implementation. I'd really like to remove the warnings ...
3
votes
1answer
43 views

use multiple .dtx file to make only .sty file

I would like to split the voluminous .dtx of eledmac in multiple .dtx file. 1) one for the user handbook 2) many other for the package code + handbook. So my objectives are: 1) have multiple .dtx ...
2
votes
1answer
53 views

Add something to the driver section inside the package code using \OnlyDescription

I would like to be able to add something to the documentation of a package in dtx format but using \OnlyDescription. I don't want the Implementation section, but somewhere on the package code I want ...
5
votes
0answers
145 views

Makefile in packages with UNIX commands and latexmk?

What are the rules regarding writing Makefiles to be part of CTAN packages? I would like to include a Makefile in a package I wrote. The package is in .dtx format with its .ins file embedded. When I ...
5
votes
1answer
145 views

\inputencoding{latin1} cannot be used in the user documentation of a .dtx file if it is \DocInput

Third edit: (As pointed out by Ulrike, my problem in fact doesn't concern listingsutf8 but only inputenc, so I reflect this by giving to the question another title and another MWE.) The following MWE ...
0
votes
1answer
57 views

Compiling documentation of a package

I have extracted the documentation of the longtable package and I want to compile it alone. By extracting the documentation I mean that I have copied the .dtx file from the \maketitle to the end and ...
12
votes
3answers
407 views

What to put into the dtx file?

Many packages are written as a single dtx file from that everything that composes the package is extracted. Apart from documentation and package code (the sty or cls), the installation instructions ...
5
votes
1answer
280 views

What exactly happens when LaTeX runs on a dtx file?

I am confused on how docstrip/ltxdoc really runs. It seems that LaTeX runs twice when called on such a simple dtx file. % \iffalse %<*installation> \expandafter\begingroup \input docstrip.tex ...
0
votes
1answer
43 views

Can \GetFileInfo read \ProvidesLanguage?

I am not sure but it seems to me that \GetFileInfo used for documentation of .dtx files ignores \ProvidesLanguage from the babel system. Why?
1
vote
1answer
67 views

Indexing in ltxdoc dtx using doc package

I've combed the documentation for a solution to this, and Googled like crazy, but haven't been able to come up with anything. I'm working on a fairly complex dtx file and have gotten the index ...
4
votes
1answer
56 views

How to display the dates in the \PrintChanges' changes?

An information I'm often missing when I have a look at the "Change History" of a package/classe is the dates of the changes because, IMHO, just the version number is not informative enough: if I could ...
2
votes
1answer
3k views

When using Caption Package, I receive: “Undefined control sequence \captionsetup ”

I introduce a figure as follows: \begin{figure} \centering \includegraphics[scale=0.300]{Figure.eps} \caption{Caption for the figure} \label{a} \end{figure} In the preamble I have written: ...
4
votes
1answer
187 views

What path provide in a .dtx file (located in source/ folder) to reach files located in doc/ folder?

For a class I want to upload on CTAN, I'd like the provided files to be organized as follows when installed by TeX distributions: 〈ROOT PATH〉/doc/latex/myclass/ myclass.pdf sample/sample.tex ...
5
votes
1answer
68 views

.DTX won't load corresponding .STY

I'm preparing a documented source for a package file and I basically use the skeleton from the ltxdoc manual verbatim. For some reason, when I compile the .dtx to generate the documentation, it just ...
7
votes
1answer
167 views

Conflict between verbatim.sty and ltxdoc.cls

I am writing a package which uses the verbatim package. \RequirePackage{verbatim} For the documentation I'm using the ltxdoc class. So I have to put an % character before every line of the ...
4
votes
2answers
91 views

Why is it not possible to embed \if construction in docstrip

I would like to create a DTX files which could be compiled in two different ways depending of a user's choice. One way to get only the user documentation, and another to get user documentation and ...
7
votes
2answers
540 views

dtx file: how to run it?

I want to clarify first that I am a beginner, and thus my question might be imprecise or inadequate. Anyway: I found this documentation file for the package microtype, can be easily found on ctan. It ...
3
votes
1answer
168 views

Removing \CheckSum and \CharacterTable for some generated files

How can you prevent \CheckSum and \CharacterTable appearing in some of the generated files (examples include README, ChangeLog, LaTeX example files, ...)?
2
votes
1answer
53 views

Using \CodelineIndex alongside other indices in a dtx file

Is it possible (and if so, 'how?') to have multiple indices (via imakeidx) in the documentation for a package/class file, and include the codeline index and change log without completely redefinining ...
8
votes
2answers
130 views

How to “\DoNotIndex \,” in a dtx file?

I'm using \EnableCrossrefs in a dtx file. In the index I now have \, indexed. I tried \DoNotIndex{{\,}} and \DoNotIndex{\thinspace} without success. Is there a way to prevent the inclusion of \, in ...
2
votes
2answers
1k views

Undefined control sequence: \undefinedpagestyle at \end{macrocode}

The full source can be found here (static link), but here is the relevant bit: ... % \begin{macrocode} %<*package> % \end{macrocode} % \begin{macro}{\BCSet} % And stuff % ...
9
votes
2answers
165 views

What is the ^^A in DTX sources?

After fleshing out (with my own project) Joseph Wright's lovely model, I've noticed that the explicit control character ^^A is used at the end of some lines. Its use appears similar to that of % to ...
4
votes
1answer
72 views

Tabular in dtx documentation

How to make table in .dtx documentation with vertical bars? % \begin{tabular}{c|c} % |sf| & \emph{mathsf}\\ % \end{tabular} fails, because |foo| is magic for verbatim.
7
votes
2answers
171 views

How to document a expl3 macro using dtx

I am writing the documentation to a package implemented in expl3 using ltxdoc, and the relevant part would look like % \begin{macro}{\conteq_args_once} % Some explanation % % \begin{macrocode} ...
1
vote
0answers
84 views

Compiling .dtx file to .sty [duplicate]

I downloaded the fancytooltips package, including the files fancytooltips.dtx and fancytooltips.ins, and then compiling three times with pdflatex fancytooltips.dtx. I see that the user guide ...
3
votes
1answer
242 views

Avoid: multicol Error: Error saving partial page

In my package I am using in the dtx file the ltxdoc class which uses multicol for the index. Currently I get this error: ! Package multicol Error: Error saving partial page. See the multicol ...
9
votes
1answer
254 views

How do I move the package implementation to the back of the documentation?

I'm trying to learn how to use .dtx files, docstrip etc to produce both package code and documentation from a single file. My primary source of information so far has been Joseph Wright's model dtx ...
5
votes
1answer
289 views

disable index creation in dtx file

The following code is a minimal dtx code with ending .tex (only for the example). I try to understand when an index created and when not, how this is influenced by the loading of hyperref and fail to ...
1
vote
1answer
46 views

modifying PrintDescribeMacro of doc.sty

I would like to redefine the command PrintDescribeMacroof doc.sty in order to create a label that I can link to using hyperref. However whenever I add a label to the command I get an error ...
4
votes
1answer
91 views

index completely messed up in dtx file

I fight with the strange and useless entries of the index in dtx files. It can reproduced with % \iffalse %<*driver> \ProvidesFile{dtxcode.tex} %</driver> % %<*driver> ...
11
votes
3answers
415 views

(How) Can I write a .dtx file without having to comment out *everything*?

I have a reasonable understanding now of how .dtx files work. But it's a great pain having to put a % character before every line of documentation. Also, depending on which editor you're using, it ...
11
votes
3answers
237 views

What does the “driver” section do in a .dtx file?

I've read the docstrip documentation, but have yet to form an intuition about how package documentation is extracted when I simply run pdflatex package.dtx. Let's say I'm using the simple dtxtut ...
5
votes
1answer
3k views

Manually install packages from dtx file on ubuntu [duplicate]

Possible Duplicate: How do I install an individual package on a Linux system? My TeXLive doesn't have the standalone package. I read part of the documentation, the PDF file from the ...
7
votes
1answer
274 views

getfileinfo not working in Joseph Wright's model dtx file creating a class

I love Joseph Wright's model dtx file for style file creation, but would like to use it for classes, too. So I did some replacements in it (sty -> cls and the like) and got this democls.dtx: % ...
6
votes
2answers
160 views

dtx file and history

The \changes command of DTX file is used to record changes. The \PrintChanges command print the list of change, sorted by number ... except when a number is greater than 10. To see the problem, I ...
7
votes
1answer
185 views

How to get a correct README when using a dtx file

I use Joseph Wright's model dtx file. Unfortunately, when using it, the generated README.txt file contains parts of the package code, which is of course unwanted. The rather long minimal example is ...
4
votes
2answers
134 views

A dangerous \if@ in the dtx preamble

Why does the following .dtx not compile, while the equivalent .tex file does? (You must name the file error.dtx, that's what \DocInput includes.) DTX: % \iffalse meta-comment %<*driver> ...
4
votes
1answer
202 views

how to organise common preamble of dtx files

I have some new packages (see latexthesistemplate/trunk/packages/template which all use a shared preamble file. I want all of them to have the same packages and commands available and the same ...
4
votes
1answer
98 views

\batchinput (docstrip) in a different directory

docstripprovides the macro \batchinput, which calls a separate ins file. This file can be in a different directory with, say: \batchinput{../contrib/xx.ins} and they are generated, but in the same ...
2
votes
1answer
135 views

dtx: add code to sty file without printing it to pdf

I want to add comments to the sty file that should not be printed to the pdf, because the description is almost identical. Is it possible to configure the dtx file, such that not every code added to ...
9
votes
2answers
12k views

Where do I get the everyshi.sty file from?

I've downloaded and unzipped the ms folder which supposedly has the everyshi.sty file; however, to my dismay, the folder has every other file but that one! As a result, I'm failing to run TikZ, since ...
2
votes
1answer
111 views

Resetting line count in dtx files

I'm writing a dtx file containing several source files. Is there a way to reset the line counter when commenting the code of a different file? My dtx file looks something like this: .... %\iffalse ...
1
vote
1answer
920 views

Problem with dtx code: rowcolors unknown

I get the following error in my .dtx file: ) (./test.dtx ! Undefined control sequence. l.35 % \rowcolors {1}{colorrow}{colorbody} which I do not understand since xcolor and colortbl are loaded and ...