viewing manual requires Internet connection

Bug #1343113 reported by Be
8
This bug affects 1 person
Affects Status Importance Assigned to Milestone
Mixxx
Fix Released
Medium
Be

Bug Description

Going to Help>User manual from the Mixxx menus opens a web browser to http://mixxx.org/manual/1.11/ . It is unnecessarily inconvenient to require an Internet connection to read a manual for a locally installed program, especially when trying to save battery on a laptop by turning off WiFi. Mixxx installs a PDF of the manual in {install base}/share/doc/mixxx/Mixxx-Manual.pdf . Going to Help>User manual from within Mixxx should open either this locally stored PDF or an HTML copy of the manual installed with Mixxx.

Changed in mixxx:
status: New → Confirmed
importance: Undecided → Medium
milestone: none → 1.12.0
Revision history for this message
jus (jus) wrote :

* What if users install multiple versions of Mixxx? Currently we link explicitly against version specific online manuals. We need to revisit the naming scheme of the local copy.
* On OS X, we don`t even install a local copy manual per default. User action required.
* How to ensure the users get the latest upstream manual after release? We do not have an update mechanism within Mixxx.

tags: added: manual usability
Revision history for this message
Daniel Schürmann (daschuer) wrote :

We may prefer the online version if a i-net connection is available and fall back to the installed version if no connection is available (which is most likely the case when playing life)

Revision history for this message
Ferran Pujol (ferranpujol) wrote :

Maybe downloading a copy of the html manual when this has been modified. Then access the local copy when there's no internet available.

Revision history for this message
Be (be.ing) wrote :

Isn't there one release of the manual for each Mixxx release? Why prefer the online version? I don't see why it would be good for users to have the latest manual if the manual may be for a newer version of Mixxx than they are using.

Revision history for this message
Be (be.ing) wrote :

Any further thoughts on this?

Revision history for this message
Be (be.ing) wrote :

How can we reliably open a PDF viewer across OSes?

Revision history for this message
Daniel Schürmann (daschuer) wrote :
Be (be.ing)
Changed in mixxx:
status: Confirmed → In Progress
Revision history for this message
Be (be.ing) wrote :
Changed in mixxx:
status: In Progress → Fix Committed
assignee: nobody → Be (be.ing)
Revision history for this message
Raf Van De Meirssche (rafvdm) wrote :

Fixed!
Thank you!

RJ Skerry-Ryan (rryan)
Changed in mixxx:
status: Fix Committed → Fix Released
Revision history for this message
Swiftb0y (swiftb0y) wrote :

Mixxx now uses GitHub for bug tracking. This bug has been migrated to:
https://github.com/mixxxdj/mixxx/issues/7541

lock status: Metadata changes locked and limited to project staff
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.