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

Re: [PATCH 3/3] Documentation: convert tutorials to man pages

From
Jakub Narebski <jnareb@gmail.com>
Date
May 2, 2008, 09:55 UTC
Message-ID
<8fe92b430805020255r1a06e169te583c371bde83ade@mail.gmail.com>
In-Reply-To
<20080502053051.c8066c4e.chriscool@tuxfamily.org>
On 5/2/08, Christian Couder <chriscool@tuxfamily.org> wrote:
Show 7 quoted lines
> This patch renames the following documents and at the same time converts
>  them to the man page format:
>
>  cvs-migration.txt -> gitcvs-migration.txt
>  everyday.txt      -> giteveryday.txt
>  tutorial.txt      -> gittutorial.txt
>  tutorial-2.txt    -> gittutorial-2.txt

I like the rest of the series, but this I have serious doubts about. I think that manpage format is just not suitable for guides and tutorials (larger works), especially that we have HTML and beginnings of info versions.

Beside, the filenames looks stupid... githooks would go in a pinch, but other names...

-- 
Jakub Narebski
Previous: Christian CouderNext: Jeff King
Message 2 of 10 in “Documentation: convert tutorials to man pages”
  1. 3/3 Documentation: convert tutorials to man pagesChristian Couder, May 2, 2008
  2. Jakub NarebskiMay 2, 2008
  3. Jeff KingMay 2, 2008
  4. J. Bruce FieldsMay 2, 2008
  5. Christian CouderMay 3, 2008
  6. Junio C HamanoMay 3, 2008
  7. Documentation status (was Re: [PATCH 3/3] Documentation: convert tutorials to man pages)Christian Couder, May 5, 2008
  8. Junio C HamanoMay 5, 2008
  9. Jakub NarebskiMay 5, 2008
  10. Christian CouderMay 6, 2008

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.