docs March 2004

docs@lists.fedoraproject.org

26 participants
21 discussions

Help Guide Feedback - Was: Etiquette Guide
by Aaron Matteson 29 Mar '04

29 Mar '04

Hey guys and ladies :) I have finally gotten some time to start my help guide for the fedora project. It is nowhere near done yet as i only have one and a half chapters completed with a planned total of eight chapters covering both ends of a request for help and so on. What i am posting about it a request for feedback on what i have done so far, i would hate to complete it and realize that i did it wrong. Pointers would also be gratefully accepted. What i have done so far is located at http://mindstorm.ath.cx:8080/fedora-docs/help-guide/help-guide-en/ I am drawing some information in context with permission* from http://www.catb.org/~esr/faqs/smart-questions.html *permission is to comply with esr's copy policy @ http://www.catb.org/~esr/copying.html Thanks for any input. -- 0 1 0 Aaron M Matteson - GnuPG:0xD144B7FF 0 0 1 Real programmers don't document. If it was hard to write, 1 1 1 it should be hard to understand! ------------------------------------------------------------------------ http://cryptosystem.us/ - Project http://cryptosystem.us/blog/ - Blog http://mindstorm.ath.cx:8080/ - Wiki

5 8

Fedora SELinux FAQ
by Karsten Wade 23 Mar '04

23 Mar '04

These last two weeks I've been working on the SELinux pieces of the Fedora Core 2 test2 release notes. The current incarnation is available at: http://people.redhat.com/kwade/selinux/selinux-faq/selinux-faq-en/ http://people.redhat.com/kwade/selinux/selinux-faq/selinux-faq-en.xml As described below, this content will start to be released Real Soon Now(TM), and I am interested in your input. Consider content quality (clarity, ease of use, clear to non-native English readers), ability to translate well, and of course the XML. In addition, I want to add this to CVS soonest, therefore I'll need Tammy's input. Also, I just noticed that the XSL does not create a question ToC, as it does in the DSSSL Tammy wrote for the Red Hat docs. Is a bugzilla report against the fedora.xsl a good way to make a feature request such as this? I'm not feeling clued enough to tackle it myself, yet. If you want the whole story for the SELinux FAQ, here's a picture of the plans and challenges: The Plan :: The SELinux release notes are in a FAQ. Ed Bailey will take the <sect1> from me, confirm it will work within the release notes limitations, and insert that into the release notes XML. Following release, we will fork the SELinux FAQ into a standalone FAQ. This will be kept for the short term in a very easy to read and write format, such as a plain text file. Fedora SELinux developers will be writing to this FAQ often, to help handle bug reports and questions following the test2 release. After the FAQ has settled into a new shape, I will take it from the developers, massage it back into DocBook XML, and move it to the fedora-docs module in CVS permanently. I'd like to create the module in CVS right now mainly to put my work under source control, and to make it easy for me to add in the updates after I get the FAQ back. All the details haven't been worked out yet in terms of where the interim FAQ will live, and where the permanent FAQ will be accessible via URL. The Challenges :: I'm doing the FAQ using a <qandaset>. The downside is the need for keeping the XML simple for the release notes. The release notes need to be viewable in Anaconda using /usr/lib/anaconda/htmlbuffer.py, which currently is limited in its ability to handle nested lists and tables. The FAQ portion is built using a table, but it breaks reasonably gracefully. For a snapshot to be used in the release notes, I may do some magic to make them ready for the release notes. Ed suggested a <variablelist> setup, which is a fairly good method. I'm keeping the main source in the more useful <qandaset> because the canonical source will be the Fedora Core SELinux FAQ (fedora-docs/selinux-faq), so will take full advantage of DocBook. I'll have to do any number of manual exports from that for various purposes, but I think the extra work is worth having a canonical FAQ. - Karsten -- Karsten Wade this is not the .signature you are looking for http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41

3 8

RE: Unsubscribing does not work?
by Brett M. Gray 23 Mar '04

23 Mar '04

Me to please -----Original Message----- From: Phil Labonte [mailto:phil_labonte@sympatico.ca] Sent: Monday, March 22, 2004 2:21 AM To: For participants of the docs project Subject: Unsubscribing does not work? I am trying to unsubscribe form this list and whenever I click the unsubscribe button I am told that I will get an email confirmation... I never do. If I try to login I get some server error... Can someone on this list unsubscribe me? -- fedora-docs-list mailing list fedora-docs-list(a)redhat.com To unsubscribe: http://www.redhat.com/mailman/listinfo/fedora-docs-list

3 2

Fwd: Re: local device support
by NAGARAJ 23 Mar '04

23 Mar '04

----- Original Message ----- >From : tfox(a)redhat.com To : nagaraj(a)1care.org Sent : Mar 23 0:29:41 IST 2004 Subject : Re: local device support The best way to receive assistance with your problems is to join the fedora-list mailing list and ask for help there. Your question will reach many more people who might have the same problems and know of a solution. Sincerely, Tammy On Sat, 2004-03-20 at 03:32, NAGARAJ wrote: > Hai Tammy > > How are u? :) For past few days I am fed up with one problem regarding the Fedora core. > The first Problem is how I will run the " .Dat" extension file tat is movie file in Fedora core. I am unable to run through the xmms and kde tools ; U have any soultions > > The second problem is regarding the regadring the terminal services options. We instaled the K12 LTSP Terinal server rpms and we tried with the USB periphereals such as usb mouse and USB keyboards on client side. Then the other issue is the suppose the client boot fromthe Linux server throught pxe lan card and is there any possible soultion that the clisnt boot throught lan and it locally support the harddisk connected to it.. > Please help me...:::)))))) > > Expecting a reply from ur side... > > Thanks > > NAGARAJAN.C.H > Senior Engineer > FIRST SIGHT COMPUTING > New Delhi > http://www.firstsightcomputing.com > http://www.1care.org > E mail: nagaraj(a)1care.org > chnagaraj(a)firstsightcomputing.com > Delhi Contact: Bangalore Contact: > Voice: +91-11-2649-0839 Voice: +91-80-5115-0955 > Fax: +91-11-2649-0833 Fax: +91-80-5115-0954 > Cell: +91-98910-43044 Cell: +91-98862-50158 > ------------------------------------------------------------------------------ > NAGARAJAN.C.H Senior Engineer FIRST SIGHT COMPUTING New Delhi http://www.firstsightcomputing.com http://www.1care.org E mail: nagaraj(a)1care.org chnagaraj(a)firstsightcomputing.com Delhi Contact: Bangalore Contact: Voice: +91-11-2649-0839 Voice: +91-80-5115-0955 Fax: +91-11-2649-0833 Fax: +91-80-5115-0954 Cell: +91-98910-43044 Cell: +91-98862-50158 ------------------------------------------------------------------------------

2 1

Re: twiki format to docbook
by Joshua Daniel Franklin 21 Mar '04

21 Mar '04

> --- Karsten Wade <kwade redhat com> wrote: > > You just need to conform to the DocBook standards. If you parse your > > document against the DTD, then indenting should be consistent. I'm sure > > there are keybindings and other DocBook tools for Vi. Perhaps someone > > who prefers to use Vi could make a tutorial on using Vi for DocBook with > > the Fedora docs project toolchain. :) > I write DocBook with Vim, so I could probaby come up with something. Sorry for the delay, this was finals week but now I'm done. This is a pretty basic guide, but it's enough to get started and has some pointers to more information. I just added a chapter after the emacs ones. I can work on fleshing it out with any suggestions. __________________________________ Do you Yahoo!? Yahoo! Mail - More reliable, more storage, less spam http://mail.yahoo.com

3 3

Fasttrak tx2000 RAID 1 fedora kernel install
by David G Denning Jr 17 Mar '04

17 Mar '04

I have a Fasttrak tx2000 running RH9 which works fine. But I’d like to upgrade to fedora cleanly. I have my RAID 1 array partitioned so the OS is on different partition then my data. Problem is Fedora doesn’t load the fasttrak RAID driver like it should. I know I could recompile the kernel and setup that way but isn’t there a boot linux dd or boot command that would tell it to load the fasttrak modules so that the tx2000 controls the raid not the linux software raid 1 kernel. Any help would be great. Thanks, -Dave --- Outgoing mail is certified Virus Free. Checked by AVG anti-virus system (http://www.grisoft.com). Version: 6.0.614 / Virus Database: 393 - Release Date: 3/5/2004

2 1

Re: Fedora SELinux FAQ
by Steve Bonneville 16 Mar '04

16 Mar '04

Karsten Wade <kwade(a)redhat.com> wrote: > These last two weeks I've been working on the SELinux pieces of the > Fedora Core 2 test2 release notes. The current incarnation is available > at: > > http://people.redhat.com/kwade/selinux/selinux-faq/selinux-faq-en/ > http://people.redhat.com/kwade/selinux/selinux-faq/selinux-faq-en.xml > > As described below, this content will start to be released Real Soon > Now(TM), and I am interested in your input. Consider content quality > (clarity, ease of use, clear to non-native English readers), ability to > translate well, and of course the XML. In addition, I want to add this > to CVS soonest, therefore I'll need Tammy's input. Have you considered forwarding this note to fedora-selinux-list? You might get some good technical input from the folks there, too. -- Steve Bonneville

2 1

old and new? Twiki to docbook
by Dave Pawson 13 Mar '04

13 Mar '04

http://www.dpawson.co.uk/fedora/oldandnew.html Is the general writeup on using SGML tools to get from twiki to docbook. I've described it in a general way, rather than tayloring it to Fedora usage. Same directory, twikiFedora.xsl, if used instead of twikiStyle.xsl, will produce docbook with all the fedora stuff included. The only problem I haven't figured out, is resolving twiki files which don't have ---+ as their first element. Those starting with second level headings simply don't work. If needed, insert a level one heading prior to first content, then it all works. I'll update as and when I've figured it. Comments appreciated. regards DaveP

1 0

recent website changes for docs
by Tammy Fox 11 Mar '04

11 Mar '04

1. This has been updated to include a chapter on Emacs and nXML Mode thanks to Gavin Henry, a few other patches/suggestion, and an Index. I also added some brief information on how the index is auto-generated. There are probably other minor fixes as well I can't remember. I have started tagging the files in CVS as I create new versions, so next time I can send out exact diffs for those interested and so you don't have to read it all again to figure out the subtle changes. http://fedora.redhat.com/participate/documentation-guide/ 2. I posted the latest version of the Fedora Jargon Buster. It is in CVS as well, so patches and suggestions are welcome. Thanks to Dave for starting it! http://fedora.redhat.com/docs/jargon-buster/ 3. I posted the beginnings of an FAQ for the Docs Project: http://fedora.redhat.com/participate/documentation-faq/ I hope to start working on the Installation Guide and a "Quick Start" guide for getting started with the docs project this week as well. Regards, Tammy

5 20

twiki format to docbook
by Dave Pawson 10 Mar '04

10 Mar '04

The article on xml.com, http://www.xml.com/pub/a/2004/03/03/sgmlwiki.html provoked me into trying it out. I didn't work with SGML for long, and this piece is just a little on the esoteric side. The basics are that the wiki text is regular, hence parsable. SGML has a wierd set of characteristics such that "ldldldl" can be interpreted as the tag named quote, the content ldldldl and the end tag for quote. As I said, wierd. Similarly, newline---+ can be interpreted as a level one heading, etc. Anyway, so far I've got a working version for the twiki syntax but I'm wondering if its a worthwhile addition to the fedora docs toolkit? The only tool is a couple of text files, and an application from James Clark. Its part of the sp toolkit http://www.jclark.com/sp/ http://www.jclark.com/sp/sx.htm documents it. The process is fairly simple. 1. Add two lines to the wiki content, 2. Parse it as an SGML file... using sx, which then produces an XML file. Its then two minutes to wrap it up in a proper article header using XSLT and submit it. It may lead to the need to keep wiki contents fairly straightforward, e.g. inter page wiki links or WikiWord links as twiki calls them, won't tranfer quite so easily. If one of the people using the wiki could point out a fairly complex page I'll try it out and report the results. regards DaveP <tag>Old enough to have used SGML :-)</tag>

4 10

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs March 2004