Corrado, c’è un modo semplice per evidenziare a margine la descrizione sia del codice, sia della documentazione; è quello di leggere la documentazione e, direi, che How to package your package sia una buona cosa.
Confesso che io uso questi strumenti meno di quanto dovrei, ma ho una certa esperienza con alcuni pacchetti. (un pacchetto non è una classe ma può diventarlo; vedi stuttura e documentazione di toptesi; la classe è formata da poche righe che riciamano toptesi.sty un pacchetto che fa tutto quello che sembra che sia fatto dalla classe).
Per la gestione della classe documentata e del suo file dtx devi (quasi) per forza usare la classe ltxdoc; ci sono anche altre classi che permettono di gestire contemporaneamente la documentazione e il codice, ma, anche se permettono di creare file di documentazione più attraenti e colorati, on hanno, secondo me, la semplicità della classe ltxdoc. Con questa classe puoi avere un preambolo che auto-estrae il codice prima di comporne la documentazione, per cui nella parte del
Recentemente ho coricato un piccolo pacchetto testhyphens; ne trovi il file dtx nell’albero texmf-distr/source/latex/testhyphens; la documentazione contiene non solo esempi d’uso del pacchettino, ma anche cose scritte in lingue diverse, greco compreso (compresi trucchi vari per mostrare nel file di documentazione una specie di verbatim che contiene il greco (cosa abitualmente impossibile da fare con pdflatex e i pacchetti normali o i comandi del nucleo di latex)).
Comunque, come ti abbiamo detto tutti, procedi per piccoli passi.
Ciao
Claudio