E’ giusto usare l3doc per documentare un pacchetto con LaTeX3 ??

  • Creatore
    Topic
  • #121995
    bencio
    Partecipante
      Up
      0
      Down
      ::


      Non mi è chiaro se l’uso della classe l3doc è o non è raccomandato per chi sta
      scrivendo un pacchetto in cui fa uso anche della sintassi di LaTeX3.

      Le raccomandazioni nel file l3styleguide paiono rivolte principalmente,
      o esclusivamente, a chi sta lavorando per scrivere il kernel.
      Inoltre la prima pagina della documentazione (file l3doc.pdf) contiene un avviso
      perentorio che invita a considerare la classe ancora molto instabile.
      (faccio riferimento a file nella cartella l3kernel)

      D’altra parte le il sistema ltxdoc+doc+docstrip non
      accetta nomi di funzioni denominate con con la sintassi di L3.

      Se si scrive una cosa come:
      \begin{macro}{\aaa_bbb_ccc:}
      si ottiene il tipico errore di quando si usa nel testo qualche cosa
      di riservato al modo matematico.

      Il problema rilevato è simile (non identico) alle incompatibilità
      segnalate da Frank Mittelbach nella nuova documentazione di doc.

      QUESITO: devo o non devo passare a l3doc ?

      grazie per l’attenzione
      un saluto
      Battista

      p.s.: ho modificato il post eliminando
      un confronto (forse scorretto) tra vecchia e nuova versione di
      ltxdoc+doc+docstrip
      B.

    • Devi essere connesso per rispondere a questo topic.

    Go to top