Как мне настроить документацию в формате PDF для моего пакета?

Как мне настроить документацию в формате PDF для моего пакета?

Я хотел проверить синтаксис чего-то в одном из моих пакетов, и вместо того, чтобы искать файл в моей системе, я просто сделал это texdoc hobbyв командной строке. К моему ужасу, это вывело PDF, содержащийкод, а не основная документация. Когда я отправлял пакет в CTAN, я разделил документацию на две части: пользовательскую документацию и документацию кода. Поскольку последняя создается из .dtx, она называется hobby.pdf, пользовательская документация может быть названа как угодно, поэтому я выбрал hobby_doc.pdf. Вполне разумно, что texdoc hobbyсоздается hobby.pdftexdoc hobby_docсоздается пользовательская документация), но с точки зрения пользователя это не кажется правильным.

Мне кажется, есть два способа исправить это:

  1. Измените имена файлов так, чтобы код стал hobby_code.pdf, а документация hobby.pdf. В идеале я хотел бы, чтобы это было автоматически, чтобы у меня все еще было hobby.dtxи , hobby.texно pdflatex hobby.dtxпроизводит hobby_code.pdf. Я знаю, что нельзя изменить \jobnameиз документа, но поскольку это .dtx, я подумал, что, возможно, процесс компиляции не так прост, как кажется, и все равно можно изменить имя выходного файла. Так ли это?

  2. Настроить texdocтак, чтобы он texdoc hobbyуказывал на hobby_doc.pdf. Насколько я понимаю, это вполне возможно, но это нужно сделать официально. Так как мне сделать такое изменение и просто ли попросить об этом? (Если сложно, то ясно, что мне следует использовать вариант 1, даже если я не могу сделать это автоматически.)

решение1

Время от времени я видел запросы наСписок Tex Liveавторами, а также пользователями, чтобы установить другое значение по умолчанию для texdocопределенного пакета (из-за аналогичной »неправильной« документации по умолчанию). Вы, вероятно, могли бы сделать то же самое.

Связанный контент