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

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

From
Junio C Hamano <gitster@pobox.com>
Date
Mar 20, 2015, 22:38 UTC
Message-ID
<xmqqmw37cn18.fsf@gitster.dls.corp.google.com>
In-Reply-To
<CAGZ79kaDnRiUQ6=3gVvsPrkSzkNbACRvgQBSo8gmpRZ8bka84g@mail.gmail.com>
Stefan Beller <sbeller@google.com> writes:
Show 9 quoted lines
> 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).

Previous: Stefan BellerNext: Michael J Gruber
Message 10 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.