Como configuro o PDF da documentação do meu pacote?

Como configuro o PDF da documentação do meu pacote?

Eu queria verificar a sintaxe de algo em um dos meus pacotes e, em vez de procurar o arquivo no meu sistema, fiz isso texdoc hobbyna linha de comando. Para minha consternação, isso trouxe o PDF contendo ocódigo, não a documentação principal. Quando enviei o pacote para o CTAN, dividi a documentação em duas partes: a documentação do usuário e a documentação do código. Como o último é produzido a partir do .dtx, ele recebe o nome hobby.pdf, a documentação do usuário pode receber o nome que eu quiser, então eu escolhi hobby_doc.pdf. É bastante razoável que texdoc hobbyproduza hobby.pdf(e texdoc hobby_docproduza a documentação do usuário), mas isso não parece ser a coisa certa a fazer do ponto de vista do usuário.

Parece-me que há duas maneiras de corrigir isso:

  1. Mude meus nomes de arquivos para que o código se torne hobby_code.pdfe a documentação seja hobby.pdf. Idealmente, gostaria que isso fosse automático para que eu ainda tivesse hobby.dtxe hobby.texproduzisse . Eu sei que não é possível alterar dentro de um documento, mas como se trata de um arquivo , pensei que talvez o processo de compilação não seja tão simples quanto parece e ainda seja possível alterar o nome do arquivo de saída. É isso?pdflatex hobby.dtxhobby_code.pdf\jobname.dtx

  2. Configure texdocde forma que texdoc hobbyaponte para hobby_doc.pdf. Isto, pelo que entendi, é eminentemente possível, mas seria necessário fazê-lo oficialmente. Então, como faço para fazer essa mudança e é algo simples de pedir? (Se for complicado, então claramente devo usar a Opção 1, mesmo que não possa fazê-lo automaticamente.)

Responder1

Tenho visto pedidos de vez em quando noLista Tex Livepelos autores, bem como pelos usuários, para definir outro padrão texdocpara um pacote específico (devido à documentação padrão similarmente »errada«). Você provavelmente poderia fazer o mesmo.

informação relacionada