PDF documentation

Mikael Pettersson mikpe at it.uu.se
Tue Oct 16 10:45:27 EDT 2012

On Tue, 16 Oct 2012 15:22:52 +0200, Constantine Shulyupin <const at makelinux.com> wrote:
> Hi,
> I have some questions and ideas about documentation in PDF format.
> During embedded SW development I often work with documentation,
> especially datasheets in PDF format. I have some issues with such
> documentation. It is not so easy to manage a lot of PDF documents
> sometimes with strange code in file names.  It is not easy to store
> and share links to documentation.
> It is possible to reference to a PDF page in this way
> http://www.ti.com/lit/ds/symlink/omap4430.pdf#page=3D100 , but it slow
> and doesn't work in all cases.
> Sometimes it is more easy just to copy paste and send by email part of
> documentation instead of using hyperlinks.
> I found, that it is more easy work (and work collaboratively) with
> documentation in HTML format. Sometimes it is possible just to convert
> PDF to HTML.
> Questions:
> - have same issues with PDF documentation and datasheets?

No. They work just fine.

> - do you think documentation and datasheets in HTML format on a site
> can be more useful than PDF?

Fore brief overviews, html will do, but for actual technical documentation
PDF is *infinitely* better than html.

> - what PDF documentation do you use? (You can just drop a link to PDF,
> for example http://www.ti.com/lit/ds/symlink/omap4430.pdf)

CPU manuals and errata updates, ISA manuals, ABI manuals.

More information about the linux-arm-kernel mailing list