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

Re: [PATCH] Documentation: Add target to build PDF manpages

From
Michael J Gruber <git@drmicha.warpmail.net>
Date
Mar 23, 2015, 15:46 UTC
Message-ID
<55103565.9040000@drmicha.warpmail.net>
In-Reply-To
<xmqqmw37cn18.fsf@gitster.dls.corp.google.com>
Junio C Hamano venit, vidit, dixit 20.03.2015 23:38:
Show 20 quoted lines
> Stefan Beller <sbeller@google.com> writes:
> 
>> Thomas referencing reading the man page offline, made me wonder
>> why you wouldn't read the man pages itself as they can also be
>> carried around offline. But the striking point is "on an iPad", which
>> doesn't offer you the convenience of a shell etc, but pdf is fine to read
>> there. Also you can add comments to pdfs more easily that html pages
>> I'd guess.
>>
>> So the patch makes sense to me now. It's just a use case I'm personally
>> not interested in for now, but I don't oppose it as is.
> 
> Well, my comment was not about opposing to it, but was about
> questioning the usefulness of it, iow, who would
> benefit from having this patch in my tree?
> 
> I didn't see (and I still do not quite see) why people would want to
> have separate pdf files for all the subcommands (instead of say an
> .epub or .pdf that binds all the man pages and perhaps user-manual,
> just like we do for .texi/.info).

Exactly. For PDF, a combined document is more natural and will hopefully make crosslinks work as crossrefs within one document, rather than links to external documents. I'd say that would make a valuable target.

Michael
Previous: Junio C HamanoNext: Philip Oakley
Message 11 of 14 in “Documentation: Add target to build PDF manpages”
  1. Documentation: Add target to build PDF manpagesThomas Schneider, Mar 20, 2015
  2. Stefan BellerMar 20, 2015
  3. Philip OakleyMar 20, 2015
  4. Junio C HamanoMar 20, 2015
  5. Thomas SchneiderMar 20, 2015
  6. Junio C HamanoMar 20, 2015
  7. Thomas SchneiderMar 20, 2015
  8. Philip OakleyMar 20, 2015
  9. Stefan BellerMar 20, 2015
  10. Junio C HamanoMar 20, 2015
  11. Michael J GruberMar 23, 2015
  12. Philip OakleyMar 24, 2015
  13. Thomas SchneiderMar 25, 2015
  14. Junio C HamanoMar 20, 2015

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.