• Status Closed
  • Percent Complete
  • Task Type Bugs
  • Category Manual
  • Assigned To No-one
  • Operating System All players
  • Severity Low
  • Priority Very Low
  • Reported Version Daily build (which?)
  • Due in Version Undecided
  • Due Date Undecided
  • Votes
  • Private
Attached to Project: Rockbox
Opened by Marc_Guay - 2008-03-28
Last edited by bluebrother - 2012-09-23

FS#8819 - Broken Manuals are Poorly Handled

Currently if the manuals are broken, the HTML versions simply stop building at the break point and present half-finished manuals on the site, whereas the PDF versions simply don’t update. It would be wise to implement a better way of dealing with this, and possibly implementing a notification system as suggested by Nils below. Given the emphasis placed on the having new users read the manual, it’s somewaht important from an integrity standpoint that it’s available in it’s entirety at all times.

Closed by  bluebrother
2012-09-23 19:41
Reason for closing:  Out of Date
Additional comments about closing:   Warning: Undefined array key "typography" in /home/rockbox/flyspray/plugins/dokuwiki/inc/parserutils.php on line 371 Warning: Undefined array key "camelcase" in /home/rockbox/flyspray/plugins/dokuwiki/inc/parserutils.php on line 407

We now have the manual in the build system (only one is built though) so this shouldn't be a problem anymore.

I just checked it: this only applies to the html manual, the pdf is fine. Will investigate …

nls commented on 2008-03-28 22:24

The pdfs are not fine, they were just not deleted, the ones for the various ipods supporting recording are dated March 23.
It seems to be further missing Action commands, \ActionSettingsInc and \ActionSettingsDec.
However there are already \ActionSettingInc and \ActionSettingDec which seems to be a typo, this should probably be cleaned up (as everything in the code is called *Settings*.
Also the build system should probably handle broken manuals better (keep the old ones if new ones didn't build and maybe tell someone about it :)

D'oh – I forgot to commit a file when fixing it yesterday, so they built fine for me. But as there is a naming issue and pixelma is currently working on it I won't commit right now.

Has this been fixed?


Available keyboard shortcuts


Task Details

Task Editing