- openSUSE Documentation

[opensuse-doc] How to make color background in LfL Docbook XML ?
by Alexey Eremenko 22 Apr '07

22 Apr '07

hi all ! How to make color background in LfL Docbook XML ? This would be great for this: http://www.virtualbox.org/wiki/Guest_OSes -- -Alexey Eremenko "Technologov" --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

3 4

[opensuse-doc] Please provide LfL in HTML format, online browseble
by Alexey Eremenko 18 Apr '07

18 Apr '07

To Novell: Please provide LfL in HTML format, online browseble. There is a link on the page below to HTML version, but it doesn't works. :( http://developer.novell.com/wiki/index.php/Lessons_for_Lizards There are some people interested in reading it. Particularly, the VirtualBox part of it :) -- -Alexey Eremenko "Technologov" --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

2 1

[opensuse-doc] Status of SUSE Package Conventions
by Nikolay Derkach 15 Apr '07

15 Apr '07

Hello, I'm wondering what is the status of SPC. Which is the latest revision? On the page [*] I have 2 links on pdf version (rev 1.0) and html version (rev 1.1), the last contains only Part 1, that seems odd to me. [*] http://developer.novell.com/wiki/index.php/SUSE_Package_Conventions -- Regards, Nikolay Derkach

2 1

[opensuse-doc] Reusage and improvement of package descriptions
by Daniel Arnold 15 Apr '07

15 Apr '07

Hi, Some time ago at opensuse-packaging-list (http://lists.opensuse.org/opensuse-packaging/2007-01/msg00002.html) I was asking for some feedback about a cross-distribution project of mine called Pakanto but probably got lost in between other messages. Pakanto (http://pakanto.org) is a (currently) small project dedicated to improve/write distribution agnostic package descriptions ready for reusage for all Linux distros. I already have a few (hopefully) useful package descriptions there (not only in English!). However writing new ones from scratch instead of improving on top of existing ones is a quite time consuming job. As it is way better to improve upon a good basis such as your package descriptions (my current aim is to provide decent package descriptions for all "official" KDE packages in English and German until the first beta Release of KDE 4) I ask you if I can import all your KDE package descriptions (descriptions of software located at KDE Subversion repository) into Pakanto under its license conditions: http://pakanto.org/wiki/Pakanto:Licensing_requirements The Pakanto license conditions aren't much different from yours (I suppose your package descriptions do have the same license as the package, so they'd be mostly LGPL/GPL in case of KDE) they just add some extra caution in order to guarantee as less as possible troubles on reusing and maintaining these texts under the copyleft principle. I'd be really happy to provide you with improved and multilingual package description texts based on yours. Are you interested? Cheers, Daniel Arnold / Arnomane

2 1

[opensuse-doc] new article in LfL: KDE customization
by Alexey Eremenko 10 Apr '07

10 Apr '07

hi all ! I have decided that it is round for another article: "KDE customization" this time saw light, with step-by-step explanations and lot of graphics. I have written and submitted this to the LfL. Welcome to read and comment this ! -- -Alexey Eremenko "Technologov" --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

3 4

[opensuse-doc] LfL is missing in openSUSE website
by Alexey Eremenko 10 Apr '07

10 Apr '07

hi all ! Ths LfL is missing in openSUSE website. link: http://en.opensuse.org/Documentation -- -Alexey Eremenko "Technologov" --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

2 2

Re: [opensuse-doc] I would like to copy and modify Mandrake Docs into LfL
by Alexey Eremenko 10 Apr '07

10 Apr '07

Hi Jana ! I have opened the bugs you requested, and pointed to you as main allower :) > > openSUSE documentation (start-up guide) structure is incorrect and it > > lacks a lot in Part II. > > what about filing a bug report on these? Just stating the structure does > not meet your ideas is a bit vague :) It would help us a lot to be able to > understand what exactly you (and possibly others) are missing there. > Start guide structure: Well, just I think that the Mobility "Part III" must go somewhere... not be "Part III" in start guide... Maybe this section can go to the LfL or Reference guide, while only the main things remain in startup guide, such as mobile (laptop) hardware, and even then should be moved to "Part I". Reference Guide structure: Process control is good example of the poor structure of the reference guide, see here: https://bugzilla.novell.com/show_bug.cgi?id=261201 > > openSUSE documentation does explain: (start-up guide) > > > > -ls > > -vi (lacks link to vimtutor, should be added to section 8.7.1) > > hmmm, either we have added it for the Enterprise release of the doc or you > missed the link. It is in there and it will continue to be so in 10.3 for > sure. It would indeed be a shame, if it wouldn't be in there. > See bugs: https://bugzilla.novell.com/show_bug.cgi?id=261204 > > openSUSE documentation does not explain: (start-up guide) > > > > -archiving with tar https://bugzilla.novell.com/show_bug.cgi?id=261190 > > -job control in bash https://bugzilla.novell.com/show_bug.cgi?id=261184 > > -hardlinks and softlinks https://bugzilla.novell.com/show_bug.cgi?id=261193 > > -process control (ps, kill, killall, top, nice, renice, ...) https://bugzilla.novell.com/show_bug.cgi?id=261201 > > hmmm? These items may not be covered in the Start-up Guide, but please > check the Reference guide and again help us by opening a bug report > against the existing doc. We'll be happy to oblige. I have checked... most topics are not covered or poorly covered in SUSE Reference guide as well. Those are the same topic covered excellently at Mandrake (note: Mandrake, not Mandriva, as their current distro is of poor quality and lacks the good documentation they once included in Mandrake Linux 9.2 in year 2003). Speaking of SUSE - there are rumors that SUSE also had better documentation at the past days - but since I haven't saw it I can't judge.... but it would be good to have a look at past SUSE documentation and maybe update and re-introduce new chapters to current docs. One example is "mc" chapter. > > > -building and installing Free Software (from .tar.gz) > > this item would indeed be a good one to start from for LfL. But then > again, you'd never have a procedure that matches all tar packages. > Packages may come with their own special set of instructions in their > README. And it's arguable whether an entirely new newbie really is up to > compiling his own packages. ok, I might write this down to the LfL... later.... > > > -runlevels (very poor explanation in SUSE) > > hmmm, not in Start-up, but have you checked the Reference manual? If so, > please help us by filing a bug report so we can take your points and > improve the existing stuff. > Yes, I did, and didn't liked that stuff. Once I will formalize what I want I will open a bug report. > > Those are important things explained very well in Mandrake Docs. > > > > -mc > > point taken. The old - really old (SUSE Linux 7.x) - docs had a very nice > chapter on mc. I could try and investigate whether we could use these > sources and publish them as part of LfL. They'd be a good starting point, > at least. https://bugzilla.novell.com/show_bug.cgi?id=261210 > > > -screen > > Another point taken. screen really is one cool app :) Do you want to > attack the issue and cover it in LfL or would you like to see it in the > official doc? Good question... I have already showed a bit of it's functionality in LfL. Maybe I will extend my LfL's article, but would be happy to see others participating in my LfL works too... > > Our team will be happy to start brainstorming about the issues brought up > and I am pretty sure we'll find a solution that really flies and that > doesn't make neither you nor us drown in work. > Thanks ! Very nice ! Ohh, and Jana, please add yourself as "CC" to the bugs opened above, as I want you to participate in the discussions of the topics above. I have tried to add you, but bugzilla returned me an error. -- -Alexey Eremenko "Technologov" --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

3 2

[opensuse-doc] How about packaging TLDP with openSUSE?
by Alexey Eremenko 07 Apr '07

07 Apr '07

hi all ! What do you think about packaging TLDP for openSUSE? (I'm generally positive of this idea - but I have't really "filtered" their content yet - for susebility :) ) -- -Alexey Eremenko "Technologov" --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

2 1

[opensuse-doc] GIMP tutorials are lacking
by Alexey Eremenko 06 Apr '07

06 Apr '07

hi all ! I feel that GIMP tutorials are lacking badly in openSUSE... I haven't decided yet where to get them and how-to package them. Possible answer to question 1: at gug.sunsite.dk - currently I'm trying to learn what license they use for tutorials Possible answer to question 2: possibly package them with LfL ? or create a separate package, known as gimp-tutor ? What do you think about adding some GIMP tutorials to openSUSE ? link: http://gug.sunsite.dk/?page=tutorials -- -Alexey Eremenko "Technologov" --------------------------------------------------------------------- To unsubscribe, e-mail: opensuse-doc+unsubscribe(a)opensuse.org For additional commands, e-mail: opensuse-doc+help(a)opensuse.org

2 1

Re: [opensuse-doc] I would like to copy and modify Mandrake Docs into LfL
by Jana Jaeger 05 Apr '07

05 Apr '07

Hi Alexey, On Wed, 4 Apr 2007, Alexey Eremenko wrote: > openSUSE documentation (start-up guide) structure is incorrect and it > lacks a lot in Part II. what about filing a bug report on these? Just stating the structure does not meet your ideas is a bit vague :) It would help us a lot to be able to understand what exactly you (and possibly others) are missing there. > openSUSE documentation does explain: (start-up guide) > > -ls > -vi (lacks link to vimtutor, should be added to section 8.7.1) hmmm, either we have added it for the Enterprise release of the doc or you missed the link. It is in there and it will continue to be so in 10.3 for sure. It would indeed be a shame, if it wouldn't be in there. > -cd > -mkdir > -rmdir > -su > -touch > -find > -locate > -redirection & pipes > -cp > -mv > -chmod > -chown > openSUSE documentation does not explain: (start-up guide) > > -archiving with tar > -job control in bash > -hardlinks and softlinks > -process control (ps, kill, killall, top, nice, renice, ...) hmmm? These items may not be covered in the Start-up Guide, but please check the Reference guide and again help us by opening a bug report against the existing doc. We'll be happy to oblige. > -building and installing Free Software (from .tar.gz) this item would indeed be a good one to start from for LfL. But then again, you'd never have a procedure that matches all tar packages. Packages may come with their own special set of instructions in their README. And it's arguable whether an entirely new newbie really is up to compiling his own packages. > -runlevels (very poor explanation in SUSE) hmmm, not in Start-up, but have you checked the Reference manual? If so, please help us by filing a bug report so we can take your points and improve the existing stuff. > Those are important things explained very well in Mandrake Docs. > > -mc point taken. The old - really old (SUSE Linux 7.x) - docs had a very nice chapter on mc. I could try and investigate whether we could use these sources and publish them as part of LfL. They'd be a good starting point, at least. > -screen Another point taken. screen really is one cool app :) Do you want to attack the issue and cover it in LfL or would you like to see it in the official doc? Our team will be happy to start brainstorming about the issues brought up and I am pretty sure we'll find a solution that really flies and that doesn't make neither you nor us drown in work. Thanks for starting this discussion! Jana -- Jana Jaeger jjaeger(a)suse.de SUSE LINUX Products GmbH Documentation Maxfeldstr. 5 +49 (0) 911 74053-0 D-90409 Nuernberg http://www.novell.com/linux SUSE LINUX Products GmbH, GF: Markus Rex, HRB 16746 (AG Nürnberg)

3 3