4936 2013-07-28 12:34:08 +0000 No PDF format distributed for the documentation 2013-10-31 14:45:24 +0000 1 1 9 Documentation General Docs docs-general unspecified x86 Multiple VERIFIED FIXED 24 September 2013: Re-assigned to Jeff Medium enhancement 1.5 1 lpapp jefro corneliux.stoicescu jefro ola.x.nilsson richard.purdie ross.burton sgw srifenbark --- --- Yes (doc changes required) oldest_to_newest 35031 0 lpapp 2013-07-28 12:34:08 +0000 I cannot downloads pdfs off-hand for offline or/and convenient reading instead of http browser reading or manual converting in here: https://www.yoctoproject.org/documentation/current It is quite a general practice in projects to ship those. 35039 1 lpapp 2013-07-28 23:07:01 +0000 Just as an addition, I have been told that gerrit is not used in this project because it lacks proper offline reading support. Now, imagine that without PDFs, but html, it is pretty hard to achieve the same for the documentation. 35049 2 jefro 2013-07-29 06:30:08 +0000 We have a low-priority, long-term goal to add PDF generation to our documentation process. It is not a high priority because very few people have asked for it. This would be a great opportunity to help the Yocto Project. If you wanted to help with this feature, we need an XML transform from our current DocBook-based format to PDF. If this is something you would like to help with, please feel free to contact me directly. As a workaround, all of the docs are available on your system when you download Poky, and you can read them in HTML locally with a browser. 35050 3 lpapp 2013-07-29 06:34:25 +0000 Why it is not even a workaround is the fact that we do not download poky for our phones or even tablets. 35269 4 ross.burton 2013-08-01 13:22:57 +0000 I'd say that having PDF and ePub forms of the documentation available for downloading would be quite useful, in particular generation of PDF is non-trivial. As Jeffrey said, any help with actually turning the DocBook source into PDF would be appreciated, sadly it's not a one-click thing. 35619 5 srifenbark 2013-08-13 12:28:07 +0000 Currently, if the user "makes" a YP manual (excluding the Quick Start and the mega-manual), they end up with a PDF version of the manual in the manual's documentation directory. So the mechanism is in place to have a PDF file for all but two of the manuals. We need to decide how to distribute these PDF versions. It would be easy to place links in the Documentation page of the YP website that would allow a person to download a PDF manual. It would also be easy to include the generated PDF versions of manuals in the documentation folder in the poky repository. Scott 35620 6 lpapp 2013-08-13 12:29:51 +0000 I vote for the former. I would like to download that on my mobile from the browser and read that while traveling etc without dealing with the low-level details, i.e. repository. 37133 7 srifenbark 2013-09-24 15:23:57 +0000 Hi, I am re-assigning this bug to Jefro as it requires changing the Docs "Current" page to include some linking mechanism to the PDF manual. Scott 37137 8 lpapp 2013-09-24 15:31:33 +0000 In my opinion, it is better if the PDFs are downloadable off-hand without going to the repository. It makes them easier accessible. 37594 9 jefro 2013-10-03 21:50:11 +0000 *** Bug 5306 has been marked as a duplicate of this bug. *** 37990 10 jefro 2013-10-16 19:09:58 +0000 The Currents page now lists PDF downloads for all documents that have PDF files available. 37991 11 lpapp 2013-10-16 19:13:33 +0000 Thanks to everyone involved. 37992 12 srifenbark 2013-10-16 19:15:16 +0000 Yes - thanks Jeff for getting the links up. 38342 13 corneliux.stoicescu 2013-10-31 14:44:35 +0000 setting to VERIFIED. 38344 14 lpapp 2013-10-31 14:45:24 +0000 Thanks.