l3build seems to ignore \usedir - TeX

TopAnswers TeX

Meta

Databases

TeX

Code Golf

APL

C++

.net

db<>fiddle

Java

*nix

PHP

PowerShell

Python

Rust

टेक्-मराठी

Typst

Web Client Dev

Web Server Dev

l3build seems to ignore \usedir

add tag

joulev

## Working directory

The following three files, `testpkg.dtx`, `testpkg.ins` and `build.lua` are in the same directory:

### `testpkg.dtx`

```
% \iffalse
%<*driver>
\documentclass{ltxdoc}
\begin{document}
\DocInput{testpkg.dtx}
\end{document}
%</driver>
% \fi
% \section{Main package file}
%    \begin{macrocode}
%<*main>
\ProvidesPackage{testpkg}
\input{testpkg.code.tex}
%</main>
%    \end{macrocode}
% \section{Code file}
%    \begin{macrocode}
%<*code>
\def\foo{A nice macro}
%</code>
%    \end{macrocode}
```

### `testpkg.ins`

```
\input docstrip.tex
\keepsilent
\askforoverwritefalse
\usedir{tex/latex/testpkg}
\generate{\file{testpkg.sty}{\from{testpkg.dtx}{main}}}
\usedir{tex/latex/testpkg/src}
\generate{\file{testpkg.code.tex}{\from{testpkg.dtx}{code}}}
\endbatchfile
```

### `build.lua`

```lua
module = "testpkg"
installfiles = {"*.sty", "*.code.tex"}
packtdszip = true
```

## What I did

Now I `cd` to that directory and run `l3build ctan`. It gives me this beautiful output:

![blob](/image?hash=85ec3db410674f8004388370b7830257bb6f5fc6446bf0bbbb55d1626728e1ca)

The command also returns `0`, so I suppose all steps are executed successfully.

## Problem

The structure of `build/distrib/tds` folder is like this:

```none
├───doc
│   └───latex
│       └───testpkg
│           └───testpkg.pdf
├───source
│   └───latex
│       └───testpkg
│           ├───testpkg.dtx
│           └───testpkg.ins
└───tex
    └───latex
        └───testpkg
            ├───testpkg.code.tex
            └───testpkg.sty
```

This TDS is good enough, and when I paste it to `~/texmf`, I am able to use `testpkg`. However, in the installer file I write this

```
\usedir{tex/latex/testpkg/src}
```

I want `testpkg.code.tex` to be put in `tex/latex/testpkg/src` and not in `tex/latex/testpkg`. So, `l3build` seems to ignore this `\usedir`.

How can I tell `l3build` to put `testpkg.code.tex` to the right place?

Top Answer

Skillmon

To control the tds structure, `l3build` uses its own settings/mechanism. For this you can specify the `tdslocations` variable, which is a list specifying the file paths of individual files in the tds with paths differing from the defaults. So to place your file `testpkg.code.tex` in `tex/latex/testpkg/src` you'll want to add the item

```lua
"tex/latex/testpkg/src/testpkg.code.tex"
```

to that list. If it is the only file with a special placement the variable initialisation in your `build.lua` file will look like the following:

```lua
tdslocations = {
	"tex/latex/testpkg/src/testpkg.code.tex",
}
```

From [David Carlisle](https://chat.stackexchange.com/transcript/message/54330066#54330066) > im a bit confused by the intent there, you could simply delete the provides package line or perhaps use `%<main>\ProvidesPackage{testpkg}` form as is done for `%<code>` that way it's in a comment at the top level but still extracted to `<main>`

TBH, I'm not that good with dtx files, too. I have my basic setup which works and reuse that setup for every package I decide to write as a dtx. What `microtype` does looks like witchcraft to me. I can ask Joseph to take a look at this thread if you want to.

I expect the above code to print `\ProvidesFile{testpkg.code.tex}` to `testpkg.code.tex`, but that is not the case. Also the log file says ``` LaTeX Warning: You have requested package `', but the package provides `testpkg'. ```

``` % \iffalse %<*main> \NeedsTeXFormat{LaTeX2e} \ProvidesPackage{testpkg} %</main> %<code>\ProvidesFile{testpkg.code.tex} %<*driver> \documentclass{ltxdoc} \begin{document} \DocInput{testpkg.dtx} \end{document} %</driver> % \fi % \section{Main package file} % \begin{macrocode} %<*main> \input{testpkg.code.tex} %</main> % \end{macrocode} % \section{Code file} % \begin{macrocode} %<*code> \def\foo{A nice macro} %</code> % \end{macrocode} ```

@Skillmon Hi. Another `docstrip` question, but I don't post it as a separate question because it sounds like I didn't read the documentation of `docstrip` properly... anyway I can't get any tags to appear before `\end{document}` of `driver` :(

Oh, I see, thanks. Actually I just saw that even in SE my message would not ping him: his username is JackDouglas and is not Jack :) Perhaps I will have to go to the Meta if I need to contact him in the future.

@Jack [not sure if this will ping you] I accidentally added the `latex3` tag, which is probably not suitable for this question. Could you please remove that tag? I use the [x] icon at the right of the tag, but for some reasons the tag doesn't go away.

@JouleV take a look at the `tdslocations` variable in `l3build`'s documentation. Putting the following in `build.lua` should work: ```lua tdslocations = { "tex/latex/testpkg/src/testpkg.code.tex", } ``` Note that this is *untested*. I have no idea how to tell `l3build` to parse the `.ins` file, though.

1 Answer