git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Cogito: Cleanup documentation building and add quick reference

From
Jonas Fonseca <fonseca@diku.dk>
Date
Mar 10, 2006, 14:41 UTC
Message-ID
<20060310144106.GA7920@diku.dk>
Hi,

Here are a few patches that makes it possible to build documentation as PDF using docbook2pdf (chosen because xmlto doesn't seem to be able to generate PDFs).

All the patches leads up to adding a quick reference with often used Cogito commands and associated option. It is inspired by svn-ref and the goal is to have the PDF version under two pages long. The grouping of commands could need some more comments.

The quick reference can be translated into HTML, PDF and cg-ref(7) manpage. The last one is achieved by stripping much of the markup from the 'default' version since manpages cannot have table layout. Note the HTML and PDF versions are generated as quick-reference.{html,pdf}. We might want to generate cg-ref.{html,pdf} instead.

-- 
Jonas Fonseca
Next: Jonas Fonseca
Message 1 of 6 in “Cogito: Cleanup documentation building and add quick reference”
  1. Jonas FonsecaMar 10, 2006
  2. 1/4 Simplify wildcards for match files to be ignoredJonas Fonseca, Mar 10, 2006
  3. 2/4 Encode the manpage section in the file nameJonas Fonseca, Mar 10, 2006
  4. 3/4 Generate PDF documents using docbook2pdfJonas Fonseca, Mar 10, 2006
  5. 4/4 Add quick referenceJonas Fonseca, Mar 10, 2006
  6. 4/4 Add quick referenceJonas Fonseca, Mar 11, 2006

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.