docs September 2005

docs@lists.fedoraproject.org

21 participants
33 discussions

Re: CVSROOT avail,1.13,1.14
by Paul W. Frields 30 Sep '05

30 Sep '05

On Fri, 2005-09-30 at 11:10 -0400, Ray Strode wrote: > > Call to a few select RH'ers... Do you think the maintainers of > > redhat-menus (hopefully I hit at least one of them on the CC list above) > > would have a problem issuing an update that puts the "Documentation" > > directory back in the menu system? > I think this is a question for Seth. I'll defer to him. If he thinks > it's a good idea, then we can figure something out. > > > I can't seem to figure out a graceful way of adding our stuff into the > > Main Menu without it -- it just ends up in "Other" when I use the > > "Documentation" category, and I haven't been able to figure out how to > > make a drop-file for /etc/xdg/menus/applications-merged/ to make this > > work. If either of them had input, that would be great, even if that > > input is "you're an idiot, here's the drop file you need." (The first > > part all by itself is not as helpful, probably.) > There might be a way, I'd have to investigate. Mark, do you know? Thanks for checking on this, Ray. I added this to Bugzilla as an RFE (#169627); I hope that was not an annoyance. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

1 0

good <ulink> practice
by Karsten Wade 30 Sep '05

30 Sep '05

We had a discussion today, and decided that this is the best method for using <ulink>: <ulink url="http://www.apache.org"/> This makes the link text be drawn from the URL attribute, in both online and print versions. This way the URL is not lost, as it would be in this method: <ulink url="http://www.apache.org">Apache Foundation website</ulink> - Karsten -- Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41 Red Hat SELinux Guide http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/

5 7

Minutes FDSCo 27 Sep 2005
by Paul W. Frields 30 Sep '05

30 Sep '05

FDSCo meeting 20 September 2005 irc.freenode.net, #fedora-docs Canonical schedule and tasks: http://fedoraproject.org/wiki/DocsProject/FedoraDocsSchedule Summary of Updates and New Tasks: ================================= * FDP continues to pursue a toolchain that is both 100% free and in line with what the upstream DocBook developers are using. Gavin is working with Tommy to find or create one or more suitable packages for a free toolchain and possibly entry into Fedora Extras. FDP has not received any significant positive feedback for helping with FOP issues to date. * Gavin will draft contact letter to be emailed to each author currently listed on wiki, and will post a draft to the FDSCo list for discussion. * Stuart is working with Patrick Barnes to come up with guidelines for wiki doc drafting. Discussion to take place on f-docs-l on guidelines for wiki markup. ** NOTE: Stuart and Patrick are often available on ** IRC at #fedora-wiki for authors to consult, or to ** discuss any other wiki issues. * Stuart will work on conversion of new RPM Guide chapters from .SXW to DocBook XML, and post progress to the list, hopefully before he departs for FUDCON. * Paul will pick up publishing of some docs to f.r.c, including republishing Developers Guide and other UTF-8 needy docs, and the mirror-tutorial. * Paul will Bugzilla as RFE a change to f.r.c/css/print.css to make monospace text more readable. Attending: ========== Karsten Wade (quaid) Tommy Reynolds (megacoder) Gavin Henry (G2) Stuart Ellis (elliss) Paul Frields (stickster) -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

2 1

Re: CVSROOT avail,1.13,1.14
by Paul W. Frields 29 Sep '05

29 Sep '05

On Wed, 2005-09-28 at 18:21 -0400, Karsten Wade wrote: > Author: kwade > > Update of /cvs/fedora/CVSROOT > In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18929 > > Modified Files: > avail > Log Message: > Some traction on this guide? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Ha! Just republishing as UTF-8 for now. But this would be the right place to canonize what's on the Wiki for posterity, methinks. Call to a few select RH'ers... Do you think the maintainers of redhat-menus (hopefully I hit at least one of them on the CC list above) would have a problem issuing an update that puts the "Documentation" directory back in the menu system? I can't seem to figure out a graceful way of adding our stuff into the Main Menu without it -- it just ends up in "Other" when I use the "Documentation" category, and I haven't been able to figure out how to make a drop-file for /etc/xdg/menus/applications-merged/ to make this work. If either of them had input, that would be great, even if that input is "you're an idiot, here's the drop file you need." (The first part all by itself is not as helpful, probably.) -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

2 4

mirror-tutorial BETA
by Paul W. Frields 29 Sep '05

29 Sep '05

The mirror-tutorial BETA is available at http://fedora.redhat.com/docs/beta/mirror-tutorial/ for review and comment. Please file bugs or RFEs against product "Fedora Documentation," component "mirror-tutorial." -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

1 0

Re: packaging docs-common
by Paul W. Frields 29 Sep '05

29 Sep '05

On Wed, 2005-09-28 at 15:00 -0400, James Laska wrote: > On Wed, 2005-09-28 at 14:39 -0400, Paul W. Frields wrote: > > Oh, I'm seeing your point now. I allowed my brain to drift away from > > the "docs-common" stuff and onto the case of the specific tutorials. It > > would be helpful, though, to keep a docs-common specific Makefile in > > Docs CVS, though, wouldn't it? > > > > I do think it would be useful to keep it in line with other fedora-* > > namespace RPMs, i.e. use %{_datadir}/fedora/<something> to store the > > "glue." My current plan is to use /usr/share/fedora/doc/* for our > > stuff. I'm assuming you probably don't care one way or the other, as > > long as it's not somewhere insane. > > Not at all, which ever you feel is the best place for this stuff. I was > just using the spec and Makefile as a proof of concept. Probably a good > idea to state each file in the spec file (rather than using globs like > common/*). I modeled the Makefile and spec file after anaconda and > logrotate in an effort to work well with our build system, although I'm > not too familiar with how the build system for extras works. Long term, > will the fedora docs and the "goods" required to build them be packaged > in FC or FC-Extras? ABSOLUTELY! Our goal is to have these in Core, since they are (1) small, (2) nonduplicative, and (3) may presuppose lack of connection to the outside world (e.g. the user is having troubles and needs docs but has no Web access). I am an Extras contributor and will be taking care of this, no fear. But your continued input is greatly appreciated for giving me use cases I hadn't considered. We should probably move this discussion to f-docs-l; I'm setting reply-to and CC appropriately. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

1 0

Self Introduction - And request to be added to DocWriters Group.
by Matt Bird 29 Sep '05

29 Sep '05

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi all, My names Matthew Bird living in Birmingham UK. Im currently a consultant working with Redhat Enterprise and Fedora and have written a range of internal documentation. In addition I have been a Redhat user since v5.6 and think it's about time I gave something back. Initially I'd like to complete the GPG documentation at http://fedoraproject.org/wiki/DocsProject/UsingGpg/CreatingKeys by adding a section on key revocation. Hopefully after that I'll be able to continue to add/amend documentation on encryption,security and other topics. GPG Info: pub 1024D/43A25816 2005-07-21 [expires: 2006-07-21] ~ Key fingerprint = A0B6 3F47 77C5 5A72 AB0C D0D7 9F83 D983 43A2 5816 uid Matthew Bird <mb(a)manasystems.co.uk> sub 4096g/73E92A67 2005-07-21 [expires: 2006-07-21] Regards Matt -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (GNU/Linux) Comment: Using GnuPG with Fedora - http://enigmail.mozdev.org iD8DBQFDOZ7on4PZg0OiWBYRAoYUAJ97eqWhtxynxmjWh9PUr3c8ZZuFEACaAuZI /corJkcDVK1AVKPLBkf9TfE= =e0Ak -----END PGP SIGNATURE-----

2 1

Self-Introduction: Francesco Tombolini
by Francesco Tombolini 26 Sep '05

26 Sep '05

Hi, all My name is Francesco Tombolini from Rome, Italy; I work as system administrator for a government office in my country. I wish to translate existing fedora documentation in my idioma. I have translated the following fedora core documentation: Understanding and Customizing the Apache HTTP SELinux Policy by Colin Walters at this url: http://www.adamantio.net/content-cat-7.html Udev on Fedora by Harald Hoyer at this url http://www.adamantio.net/article265.html Fedora Core 3 SELinux FAQ by Karsten Wade and other selinux FAQs at this address: http://www.adamantio.net/faq.html I'm an active translator and mantainer of italian locale of the following packages: system-config-lvm system-config-bind system-config-securitylevel I have suggested some q/a inclusion in Translation Project FAQs, recently evaluated and published by Sarah Wang. My computer skills are considered medium-high for my working environment, I have worked for near 7 years on Irix and linux, platform. Best regards to all. pub 1024D/F1405F73 2005-09-12 Key fingerprint = EDA9 7504 AA93 CEFC 5990 1356 8584 6B05 F140 5F73 uid Francesco Tombolini (Share what you know, learn what you dont) <tombo(a)adamantio.net> sub 1024g/62931B8D 2005-09-12 -- Francesco Tombolini <tombo(a)adamantio.net>

2 1

Simple MoinMoin > DocBook Sample
by Stuart Ellis 23 Sep '05

23 Sep '05

Raw Wiki format: http://mythic-beasts.com/~hobb/fedora/EssentialSoftware.txt DocBook output: http://mythic-beasts.com/~hobb/fedora/EssentialSoftware.xml The original Wiki page is: http://fedoraproject.org/wiki/Docs/Drafts/EssentialSoftware Generating DocBook from MoinMoin: on a standard MoinMoin 1.3.5 installation, add "?action=format&mimetype=xml/docbook" to the page URL, e.g. http://wiki.me.com/SamplePage http://wiki.me.com/SamplePage?action=format&mimetype=xml/docbook (This doesn't work on the Fedora Wiki, which is MoinMoin 1.3.4) -- Stuart Ellis stuart(a)elsn.org Fedora Documentation Project: http://fedora.redhat.com/projects/docs/ GPG key ID: 7098ABEA GPG key fingerprint: 68B0 E291 FB19 C845 E60E 9569 292E E365 7098 ABEA

2 1

KDE help system
by Paul W. Frields 21 Sep '05

21 Sep '05

Can anyone give me a thumbnail, or provide a link to same, explaining the KDE Help system and how to install documents therein? I have a handle on scrollkeeper and Yelp for GNOME but no idea how to proceed with KDE. This will be part of the rollout of FDP documentation into the distribution as RPM packages. -- Paul W. Frields, RHCE http://paul.frields.org/ gpg fingerprint: 3DA6 A0AC 6D58 FEC4 0233 5906 ACDB C937 BD11 3717 Fedora Documentation Project: http://fedora.redhat.com/projects/docs/

2 1

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs September 2005