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
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
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
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.
this is not the .signature you are looking for
gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41
Me to please
From: Phil Labonte [mailto:email@example.com]
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
If I try to login I get some server error...
Can someone on this list unsubscribe me?
fedora-docs-list mailing list
----- 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
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...
> Senior Engineer
> FIRST SIGHT COMPUTING
> New Delhi
> E mail: nagaraj(a)1care.org
> 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
FIRST SIGHT COMPUTING
E mail: nagaraj(a)1care.org
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
> --- 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
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.
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
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
> 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
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.
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.
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
3. I posted the beginnings of an FAQ for the Docs Project:
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.
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.
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
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.
<tag>Old enough to have used SGML :-)</tag>