¿Cómo configuro el PDF de documentación para mi paquete?

¿Cómo configuro el PDF de documentación para mi paquete?

Quería comprobar la sintaxis de algo en uno de mis paquetes y, en lugar de buscar el archivo en mi sistema, simplemente lo hice.texdoc hobby en la línea de comando. Para mi consternación, esto abrió el PDF que contiene elcódigo, no la documentación principal. Cuando envié el paquete a CTAN, dividí la documentación en dos partes: la documentación del usuario y la documentación del código. Como este último se produce a partir de .dtx, recibe un nombre hobby.pdf, la documentación del usuario puede tener el nombre que quiera, así que elegí hobby_doc.pdf. Es bastante razonable que texdoc hobbyproduzca hobby.pdf(y texdoc hobby_docproduzca la documentación del usuario), pero no parece lo correcto desde la perspectiva del usuario.

Me parece que hay dos formas de solucionar este problema:

  1. Cambiar mis nombres de archivos para que el código hobby_code.pdfy la documentación sean hobby.pdf. Idealmente, me gustaría que esto fuera automático para que todavía tenga hobby.dtxy hobby.texproduzca . Sé que no se puede cambiar desde un documento, pero como se trata de un documento , pensé que tal vez el proceso de compilación no sea tan simple como parece y aún sería posible cambiar el nombre del archivo de salida. ¿Lo es?pdflatex hobby.dtxhobby_code.pdf\jobname.dtx

  2. Configure texdocde modo que texdoc hobbyapunte a hobby_doc.pdf. Esto, según tengo entendido, es eminentemente posible, pero sería necesario hacerlo oficialmente. Entonces, ¿cómo hago para realizar ese cambio? ¿Es algo sencillo de solicitar? (Si es complicado, entonces claramente debería usar la Opción 1 incluso si no puedo hacerlo automáticamente).

Respuesta1

He visto solicitudes de vez en cuando en elLista de Tex en vivotanto por los autores como por los usuarios para establecer otro valor predeterminado texdocpara un paquete específico (debido a una documentación predeterminada igualmente »incorrecta«). Probablemente tú puedas hacer lo mismo.

información relacionada