[opensuse] The Missing SUSE manual: Missing documentation?
I'm stumped. I've tried to figure out what package it might be in, but a couple of times I've gone to read the /usr/share/doc/manual/ and tried the opensuse-manual_en-pdf dir for the "pdf". But the only thing in the directory is a LICENSE.txt file: Copyright © 2006-2009 Novell, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 .... SUSE®, openSUSE®, the openSUSE® logo, Novell®, the Novell® logo, the N® logo, are registered ... blah blah blah ------------------------ The Copyright is current up to 2009 and openSUSE is mentioned, but no pdf on my distro. I've looked through my index of files of all rpms, but can't seem to find it. Anyone know what package the pdf is in? Thanks, -linda -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Fri, 06 Nov 2009 17:46:03 -0800
Linda Walsh
I'm stumped. I've tried to figure out what package it might be in, but a couple of times I've gone to read the /usr/share/doc/manual/ and tried the opensuse-manual_en-pdf dir for the "pdf". But the only thing in the directory is a LICENSE.txt file:
Copyright © 2006-2009 Novell, Inc. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 .... SUSE®, openSUSE®, the openSUSE® logo, Novell®, the Novell® logo, the N® logo, are registered ... blah blah blah
------------------------
The Copyright is current up to 2009 and openSUSE is mentioned, but no pdf on my distro. I've looked through my index of files of all rpms, but can't seem to find it.
Anyone know what package the pdf is in?
Thanks, -linda Hi The way I understand if from the change log;
* Thu Sep 6 2007 coolo{at}suse.de - As discussed with Tanja and Jana: pdfs should not be installed by default They are present in the src rpm as that's where they get copied by the spec file that builds the rpm. Download the src and get the pdf's from there perhaps? -- Cheers Malcolm °¿° (Linux Counter #276890) SUSE Linux Enterprise Desktop 11 (x86_64) Kernel 2.6.27.37-0.1-default up 3 days 23:05, 2 users, load average: 0.10, 0.09, 0.12 GPU GeForce 8600 GTS Silent - CUDA Driver Version: 190.18 -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
Malcolm wrote:
The way I understand if from the change log;
* Thu Sep 6 2007 coolo{at}suse.de - As discussed with Tanja and Jana: pdfs should not be installed by default
That's just lame! Why bother to install an empty directory? The package is installed, and contains nothing? If someone installs the package, it doesn't make sense to not install the contents of the package. The total contents of the package: /usr/share/doc/manual /usr/share/doc/manual/opensuse-manual_en-pdf /usr/share/doc/manual/opensuse-manual_en-pdf/LICENSE.txt What's the point of installing an empty package? That just seems really broken. -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Friday, 2009-11-06 at 20:42 -0800, Linda Walsh wrote:
That's just lame! Why bother to install an empty directory?
The package is installed, and contains nothing? If someone installs the package, it doesn't make sense to not install the contents of the package.
The total contents of the package: /usr/share/doc/manual /usr/share/doc/manual/opensuse-manual_en-pdf /usr/share/doc/manual/opensuse-manual_en-pdf/LICENSE.txt
The 11.0 package contains: /usr/share/doc/manual /usr/share/doc/manual/opensuse-manual_en-pdf /usr/share/doc/manual/opensuse-manual_en-pdf/APPARMOR-admin_en.pdf /usr/share/doc/manual/opensuse-manual_en-pdf/opensuse-gnomequick_en.pdf /usr/share/doc/manual/opensuse-manual_en-pdf/opensuse-kdequick_en.pdf /usr/share/doc/manual/opensuse-manual_en-pdf/opensuse-reference_en.pdf /usr/share/doc/manual/opensuse-manual_en-pdf/opensuse-startup_en.pdf I haven't checked 11.2.
What's the point of installing an empty package?
None.
That just seems really broken.
- --> bugzilla! - -- Cheers, Carlos E. R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkr1YvkACgkQtTMYHG2NR9UdaACgkE+gxwlFQj42PWaFF45BIOZH OoAAnRGb70dnch0aoxznc+PkM+iD0kIY =+vsJ -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Fri, Nov 06, 2009 at 05:46:03PM -0800, Linda Walsh wrote:
I'm stumped. I've tried to figure out what package it might be in, but a couple of times I've gone to read the /usr/share/doc/manual/ and tried the opensuse-manual_en-pdf dir for the "pdf". But the only thing in the directory is a LICENSE.txt file:
Looks like you hit https://bugzilla.novell.com/show_bug.cgi?id=481926 too. The initial report was for openSUSE 11.1 and is still valid for 11.2. But see Karl's comment #4. Therefore I expect updates which include some kind of documentation PDF stub. Lars -- Lars Müller [ˈlaː(r)z ˈmʏlɐ] Samba Team SUSE Linux, Maxfeldstraße 5, 90409 Nürnberg, Germany
On Saturday November 7 2009 6:44:15 am Lars Müller wrote:
But see Karl's comment #4. Therefore I expect updates which include some kind of documentation PDF stub.
Is there really no open source alternative to PDF files? Maybe whatever the heck Scribus uses? Or at least .war files (tarred web pages as saved by Konqueror)? Sure, these are KDE... but I don't use Gnome. Maybe TeX files? Help me out here, people. By the way, do the current versions of the distro still come with an RPM of HOWTO files? I don't even remember if my current 11.0 did. -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Wed, Nov 11, 2009 at 05:48:38AM -0600, Constantinos Galilei wrote:
On Saturday November 7 2009 6:44:15 am Lars Müller wrote:
But see Karl's comment #4. Therefore I expect updates which include some kind of documentation PDF stub.
Is there really no open source alternative to PDF files? Maybe whatever the heck Scribus uses? Or at least .war files (tarred web pages as saved by Konqueror)? Sure, these are KDE... but I don't use Gnome. Maybe TeX files? Help me out here, people.
By default the documentation is available as in the HTML format. PDF is optional. Lars -- Lars Müller [ˈlaː(r)z ˈmʏlɐ] Samba Team SUSE Linux, Maxfeldstraße 5, 90409 Nürnberg, Germany
On Wednesday November 11 2009 7:54:46 am Lars Müller wrote:
By default the documentation is available as in the HTML format. PDF is optional.
Lars
Okay, I completely misunderstood what was being said. The title of the thread says "missing documentation" and I thought it was gone period. Kind of wondered about HTML. -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Wednesday, 2009-11-11 at 05:48 -0600, Constantinos Galilei wrote:
Is there really no open source alternative to PDF files? Maybe whatever the heck Scribus uses? Or at least .war files (tarred web pages as saved by Konqueror)? Sure, these are KDE... but I don't use Gnome. Maybe TeX files? Help me out here, people.
PDF is currently an open format - I don't know exactly what type or degree of open, but it is open. You don't need to use acrobat to read it, nor to generate pdfs (with some practical limitations). And, there is no open format that can compete with PDF (with a similar feature set), for practical purposes: it is very widely known and supported, on probably every operating system. That is important.
By the way, do the current versions of the distro still come with an RPM of HOWTO files? I don't even remember if my current 11.0 did.
At least 11.0 does. - -- Cheers, Carlos E. R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkr610gACgkQtTMYHG2NR9Ui1ACfcwAg4IsX5E3Fg1TFpWrEQ7fB 8/cAoJImcda22POUIEkyBlVuoTMI2Nof =lyvA -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Wednesday November 11 2009 9:24:54 am Carlos E. R. wrote:
And, there is no open format that can compete with PDF (with a similar feature set), for practical purposes: it is very widely known and supported, on probably every operating system. That is important.
I know, but I misunderstood the original issue (see my other reply on this). Still, if there was an open format that we could use, it would make sense to provide the documentation in the distro with it if the library for it was installed by default. That's what I meant. Anyway, neither here nor there. I'll just stumble confusedly off at this point. -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Wednesday, 2009-11-11 at 23:55 -0600, Constantinos Galilei wrote:
On Wednesday November 11 2009 9:24:54 am Carlos E. R. wrote:
And, there is no open format that can compete with PDF (with a similar feature set), for practical purposes: it is very widely known and supported, on probably every operating system. That is important.
I know, but I misunderstood the original issue (see my other reply on this).
Still, if there was an open format that we could use, it would make sense to provide the documentation in the distro with it if the library for it was installed by default. That's what I meant.
Yes, that would be nice. However... the goal of any documentation reader is to be able to read always, regardless of what computer you have available, or the operating system. The fact is that PDF fulfills that role... a windows user could not read the docs (before installing linux, perhaps) if we used, say, dvi or tex. They are not so popular formats. We could invent some beter format than pdf, sure... but the problem is being able to read it anywhwere. The market has choosen a de-facto standard, which is PDF... so we'd better use it, even if it is not the best one.
Anyway, neither here nor there. I'll just stumble confusedly off at this point.
A good documentation format is something that interests me a lot. I don't fully "love" pdf, but it is what we have... as always with technical choices, it is a compromise. I think there are some other formats used on book readers, but I understand they are even more closed, DRM et al... - -- Cheers, Carlos E. R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkr7/m8ACgkQtTMYHG2NR9XCEQCfXGfQMcKIf0Tgn/9F2ERg+HU+ XOoAniv3XoFP8rETyOFvU5mFVjNybvlM =3oSP -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On Wednesday, 2009-11-11 at 23:55 -0600, Constantinos Galilei wrote:
Still, if there was an open format that we could use, it would make sense to provide the documentation in the distro with it if the library for it was installed by default. That's what I meant.
You will like this: http://www.suse.com/relnotes/i386/openSUSE/11.2/RELEASE-NOTES.en.html ] openSUSE Documentation as E-Books (EPUB) ] ] In addition to the traditional output formats PDF and HTML, the openSUSE ] system Documentation is now available as e-books in the EPUB format. ] EPUB (electronic publication) is a free and open e-book standard. For ] more information about EPUB, see http://en.wikipedia.org/wiki/EPUB. ] ] Download the EPUB files from http://en.opensuse.org/Documentation. What it doesn't say is what reader to use :-? The wikipedia mentions Calibre, EPUBReader (an add on for FF), FBReader, and Okular - it is not clear how to create them. What has Novell used? - -- Cheers, Carlos E. R. -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.9 (GNU/Linux) iEYEARECAAYFAkr8cTsACgkQtTMYHG2NR9XD+gCdFbia1jz5ay84G5fFm05qOrKe QsQAnReGhcxpeD2y8fT655J/hKMtGgiA =oAcr -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On Thursday November 12 2009 2:33:56 pm Carlos E. R. wrote:
On Wednesday, 2009-11-11 at 23:55 -0600, Constantinos Galilei wrote:
Still, if there was an open format that we could use, it would make sense to provide the documentation in the distro with it if the library for it was installed by default. That's what I meant.
You will like this:
http://www.suse.com/relnotes/i386/openSUSE/11.2/RELEASE-NOTES.en.html
] openSUSE Documentation as E-Books (EPUB) ] ] In addition to the traditional output formats PDF and HTML, the openSUSE ] system Documentation is now available as e-books in the EPUB format. ] EPUB (electronic publication) is a free and open e-book standard. For ] more information about EPUB, see http://en.wikipedia.org/wiki/EPUB. ] ] Download the EPUB files from http://en.opensuse.org/Documentation.
What it doesn't say is what reader to use :-?
The wikipedia mentions Calibre, EPUBReader (an add on for FF), FBReader, and Okular - it is not clear how to create them. What has Novell used?
Awesome information and questions. Thank you. I think I'll look into it myself. -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 11/15/2009 03:33 AM, Constantinos Galilei wrote:
On Thursday November 12 2009 2:33:56 pm Carlos E. R. wrote:
...
] Download the EPUB files from http://en.opensuse.org/Documentation.
What it doesn't say is what reader to use :-?
The wikipedia mentions Calibre, EPUBReader (an add on for FF), FBReader, and Okular - it is not clear how to create them. What has Novell used?
Awesome information and questions. Thank you. I think I'll look into it myself.
Welcome! Just tell us what you discover when you investigate it :-) - -- Cheers / Saludos, Carlos E. R. (from 11.2-ex-factory "Emerald" GM) -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.12 (GNU/Linux) Comment: Using GnuPG with SUSE - http://enigmail.mozdev.org/ iEYEARECAAYFAkr/3HYACgkQU92UU+smfQWF7QCfdJl8e71WobmO9emOVlHy91Mg RnUAni5PE2yS4icuwq1EMjLinjciFVRh =DL2h -----END PGP SIGNATURE----- -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
Hi, On Sunday 15 November 2009 Constantinos Galilei wrote:
[...]
What it doesn't say is what reader to use :-?
The wikipedia mentions Calibre, EPUBReader (an add on for FF), FBReader, and Okular - it is not clear how to create them. What has Novell used?
Awesome information and questions. Thank you. I think I'll look into it myself.
Calibre is available from my openSUSE buildserver repository, see http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=calibre Unfortunately, it is not available in openSUSE 11.2. I was a bit too late. Tom -- Thomas Schraitle ---------------------------------------------------------------------- SUSE LINUX GmbH >o) Documentation Specialist Maxfeldstrasse 5 /\\ 90409 Nuernberg _\_v http://en.opensuse.org/Documentation_Team http://developer.novell.com/wiki/index.php/Lessons_for_Lizards http://lizards.opensuse.org/author/thomas-schraitle/ --------------------------------------------------------------------- -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
On 11/16/2009 4:57 AM, Thomas Schraitle wrote:
Hi,
On Sunday 15 November 2009 Constantinos Galilei wrote:
[...]
What it doesn't say is what reader to use :-?
The wikipedia mentions Calibre, EPUBReader (an add on for FF), FBReader, and Okular - it is not clear how to create them. What has Novell used?
Awesome information and questions. Thank you. I think I'll look into it myself.
Calibre is available from my openSUSE buildserver repository, see http://software.opensuse.org/search?baseproject=openSUSE%3A11.2&p=1&q=calibre
Unfortunately, it is not available in openSUSE 11.2. I was a bit too late.
This is a pretty intriguing package. I installed it while casting around for something to read some purchased electronic books from amazon and Barnes an Nobel. By and large it worked very well as a reader of all the formats it supports. The ability to download news papers is one of the best implementations I have ever seen. Conversion from one format to another is still a bit shaky, often failing for no obvious reason with no diagnostics at all. I hope future versions will be able to upload to some of the more popular services (Amazon, B&N) which allow you to upload your books to your private bookshelf on these services for download to their reader devices. Note I used the Ubuntu version, as I did this before 11.2 came out. -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org For additional commands, e-mail: opensuse+help@opensuse.org
participants (7)
-
Carlos E. R. -
Constantinos Galilei -
John Andersen -
Lars Müller -
Linda Walsh -
Malcolm -
Thomas Schraitle