Non sono d’accordo su alcune decine di aspetti stilistici :), ma comprendo che ci siano “ordini superiori”.
Ciao Enrico,
ordini superiori a dir la verità non ce ne sono, fortunatamente non badiamo troppo alle formalità nel nostro dipartimento. Ho semplicemente cercato di non discostarmi troppo dallo stile medio delle tesi fatte finora per non sconvolgere le cose. In ogni caso sono pronto a cambiare in ogni momento, quindi accetto suggerimenti!
Quando ci sarà un documento che presenti gli aspetti principali della classe.
(5) Usa \MessageBreak nei messaggi di errore, in modo che siano leggibili.
Questo comando non lo conoscevo. Guardando in giro mi pare di capire che vada
messo nel sorgente ogni qual volta si va a capo in un messaggio di errore.
Noto altri errori. Il comando \ClassError ha tre argomenti. Il primo è il nome della classe, il secondo il messaggio di errore, il terzo il messaggio di aiuto. Nei tuoi manca il terzo argomento. Per esempio
`\newcommand\@submitdate{%
\ClassError{sapthesis}{You must specify the thesis submission date
(submitdate) in the form Month(name) Year(number)}}`
dovrebbe diventare qualcosa come
`\newcommand\@submitdate{%
\ClassError{sapthesis}{You must specify the thesis submission date}
{The date must be in the form Month(name) Year(number)}}`
Se non metti quel terzo argomento lasci chi non ha inserito la data in pasticci seri. Usa \MessageBreak in posti opportuni in modo che il messaggio non occupi più di 70 caratteri circa (compreso “! Class sapthesis Error”).
Altre osservazioni, quando ci sarà un vero documento di esempio. Il cognome scozzese (non inglese, gli scozzesi si potrebbero offendere) di Nepero è “Napier”: John Napier, 8th Laird of Merchiston.
Questa non l’ho capita! Devo scrivere il cognome originale al posto dell’italianizzato
Nepero?
Scrivere nella documentazione “Neper number” mi sembra alquanto sbagliatuccio. 🙂 Nel commento alla riga 253 della classe potrebbe anche passare inosservato, ma non lo lascerei nemmeno là.
Ciao
Enrico