docs July 2004

docs@lists.fedoraproject.org

20 participants
20 discussions

Using elvis?
by Colin Charles 09 Aug '04

09 Aug '04

Hi, We've been talking about public CVS for far too long, and I think the longer we wait, the longer Fedora Docs becomes less & less relevant Keeping in mind that the barrier of entry is already relatively high (you need to know DocBook, you need to use Emacs, etc...), this makes folk move closer to creating docs on 3rd party sites Why can't we use elvis.redhat.com ? Anaconda, translations and so on happen at elvis, so why not fedora docs? This will mean external contributors *can* commit to cvs as well Kind regards -- Colin Charles, byte(a)aeon.com.my http://www.bytebot.net/ "First they ignore you, then they laugh at you, then they fight you, then you win." -- Mohandas Gandhi

11 25

fedora-entities - a proposal in the flesh
by Karsten Wade 03 Aug '04

03 Aug '04

This one has been on my to-do list for a while ... http://people.redhat.com/kwade/fedora-docs/common/fedora-entities-en.xml This works fine in my local tree, but since it includes entities required by the build scripts, it needs more QA. See below the Background section for implementation steps. # Background If you aren't familiar with the concept here, DocBook entities allow us to objectify common words and phrases that we want to use regularly, and be able to easily update from a single location. Entries look like this:  <!ENTITY FCVER "2">  <!ENTITY TESTVER "test1">  <!ENTITY FCTESTVER "3 &TESTVER;">  In the XML it appears like this: The information in this FAQ is specific to &FC; &FCTESTVER;. If you are looking for the FAQ for &FC; &FCVER; ... Which DocBook converts into: The information in this FAQ is specific to Fedora Core 3test1. If you are looking for the FAQ for Fedora Core 2 ... # Implementing To take advantage of this common entities file, we need to do the following: 1. If the common entities file is ready for submission, get it into CVS in fedora-docs/common. I'll be responsible for making this happen, ye gods willing. 2. Update your XML to use the common file by first removing the local versions of similar entities (leave in your true local entities), and adding this line: <!ENTITY % FEDORA-ENTITIES-EN SYSTEM "../common/fedora-entities-en.xml"> %FEDORA-ENTITIES-EN; Note the relative path. Just like the build scripts, you are relying upon the various build directories in fedora-docs/ being in specific locations. The BOOKID entity is still set in each guide locally: <!ENTITY BOOKID "selinux-faq-1.3 (2004-07-30-T04:20-0800)">  I use a LOCALVER entity for the times when my guide is out of sync with the current FCVER or FCTESTVER in the common entities file. The LOCALVER would be used like this: <!ENTITY LOCALVER "3">  The information in this FAQ is relevant to &FC; &LOCALVER; only and not to the current or test release. 3. File bugzilla tickets for all the other guides in CVS that need to be updated to use the new common entities file. ## 30 - Karsten -- Karsten Wade, RHCE, Tech Writer this .signature subject to random changes http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41

2 2

[Fwd: Creating a Fedora instllation boot floppy]
by Colin Charles 02 Aug '04

02 Aug '04

David, Consider dropping this to the fedora-docs-list(a)redhat.com as this is possibly a guide Regards -- Colin Charles, byte(a)aeon.com.my http://www.bytebot.net/ "First they ignore you, then they laugh at you, then they fight you, then you win." -- Mohandas Gandhi

2 1

[Fwd: USB Key and Fedora Core 2/Gnome2.6 How-To]
by Colin Charles 01 Aug '04

01 Aug '04

Don't know if we can make this of use in the Docs Project, but it might be handy The author, and Tim has been CC'ed as well This adds to Tim Waugh's guide http://cyberelk.net/tim/usb-storage.html, and I think will make a good HOWTO/Guide for the docs project For FC3, we might want to touch on gamin as well -- Colin Charles, byte(a)aeon.com.my http://www.bytebot.net/ "First they ignore you, then they laugh at you, then they fight you, then you win." -- Mohandas Gandhi

3 2

Fedora Doc List used as Help Desk
by redwire＠therockmere.com 31 Jul '04

31 Jul '04

I agree that we need to clarify the actual usage of this mailing list. But, as was mentioned in one of the preceding posts: there aren't any Published DOCS for Fedora. And, we are the DOCS link mentioned on the Fedora Main Page. Maybe if we released some documentation for posting to the Fedora Website we could negate a number of these 'request for help' type postings. Just my opinion. Brad p.s. I've been locked out of the CVS to retreive the examples. Can someone repost the synatax for getting the docs from CVS. Also, if I wasn't just imagining that I could D'L from the CVS if you could confirm that I'd sleep better at night. I have a doc on YUM conversion from RH9 to FC 1 or 2, but I can't finish cleaning it up until I can check the examples. TIA...Brad

3 2

Problems using a wireless mouse unfer FC2
by Pablo 31 Jul '04

31 Jul '04

I´ve got a wireless USB keyboard + optical mouse in a machine running Fedora Core 2. Both devices are working perfectly. I can use the keyboard without any problem but I´m having a little trouble with the mouse. The pointer (cursor) moves perfectly -so the mouse is working- but I can´t click or use the wheel. I don´t really care about the wheel too much but no button is working. This doesn´t happen when I use a PS/2 optical mouse. And, finally, under Windowshit XP (in the same machine) it works perfectly... so, is nos the BIOS setting. And of course I played for a while with kudzu and system-config-mouse. What can I do? Is there a driver for that? Thanks. ---------------------------------------------------------------- This message was sent using IMP, the Internet Messaging Program.

6 13

what is ready for fedora.redhat.com
by Karsten Wade 30 Jul '04

30 Jul '04

Can we put together a list of what exactly is ready to post or change in either of the Docs pages at fedora.redhat.com? There are two categories: 1. Actual Documentation - http://fedora.redhat.com/docs These would be new documents or changes to existing documents. If you have specific bugzilla reports, post them. Perhaps bug reports, one for each document ready to post? I'll start the list: ## Documents Ready For Post and Maintenance Fedora Core 2 SELinux FAQ (in CVS) Fedora Core 3text1 SELinux FAQ (soon to be in CVS) 2. Docs Project - http://fedora.redhat.com/projects/docs/ Specific changes we should file as bugzilla reports, then report the bugzilla number back to this thread. If it's something for the FDP Documentation Guide, it needs a bugzilla number, and should be included in this category. - Karsten -- Karsten Wade, RHCE, Tech Writer this .signature subject to random changes http://people.redhat.com/kwade/ gpg fingerprint: 2680 DBFD D968 3141 0115 5F1B D992 0E06 AD0E 0C41

2 1

Test message
by Dave Pawson 28 Jul '04

28 Jul '04

-- Regards DaveP. XSLT&Docbook FAQ http://www.dpawson.co.uk/xsl

1 0

Fedora Project Mailing Lists reminder
by Elliot Lee 27 Jul '04

27 Jul '04

This is a reminder of the mailing lists for the Fedora Project, and the purpose of each list. You can view this information at http://fedora.redhat.com/participate/communicate/ When you're using these mailing lists, please take the time to choose the one that is most appropriate to your post. If you don't know the right mailing list to use for a question or discussion, please contact me. This will help you get the best possible answer for your question, and keep other list subscribers happy! Mailing Lists Mailing lists are email addresses which send email to all users subscribed to the mailing list. Sending an email to a mailing list reaches all users interested in discussing a specific topic and users available to help other users with the topic. The following mailing lists are available. To subscribe, send email to <listname>-request(a)redhat.com (replace <listname> with the desired mailing list name such as fedora-list) with the word subscribe in the subject. fedora-announce-list - Announcements of changes and events. To stay aware of news, subscribe to this list. fedora-list - For users of releases. If you want help with a problem installing or using , this is the list for you. fedora-test-list - For testers of test releases. If you would like to discuss experiences using TEST releases, this is the list for you. fedora-devel-list - For developers, developers, developers. If you are interested in helping create releases, this is the list for you. fedora-docs-list - For participants of the docs project fedora-desktop-list - For discussions about desktop issues such as user interfaces, artwork, and usability fedora-config-list - For discussions about the development of configuration tools fedora-legacy-announce - For announcements about the Fedora Legacy Project fedora-legacy-list - For discussions about the Fedora Legacy Project fedora-selinux-list - For discussions about the Fedora SELinux Project fedora-de-list - For discussions about Fedora in the German language fedora-es-list - For discussions about Fedora in the Spanish language fedora-ja-list - For discussions about Fedora in the Japanese language fedora-i18n-list - For discussions about the internationalization of Fedora Core fedora-trans-list - For discussions about translating the software and documentation associated with the Fedora Project German: fedora-trans-de French: fedora-trans-fr Spanish: fedora-trans-es Italian: fedora-trans-it Brazilian Portuguese: fedora-trans-pt_br Japanese: fedora-trans-ja Korean: fedora-trans-ko Simplified Chinese: fedora-trans-zh_cn Traditional Chinese: fedora-trans-zh_tw

1 0

Problems with my Lucent winmodem under FC2 !!!!
by Pablo 25 Jul '04

25 Jul '04

Hello... I'm having troubles installing my lucent winmodem under Fedora Core 2. I downloadad the lasta driver available from www.linmodem.org, succesfully compiled (with no errors at all). The symlinks are correct and both modules are generated. The problem is that the system doesn´t recognize the modules' format. Even when I try to install them with insmod or load the modules with modprobe I get an error message: "Unrecognized module format". Of course, with KPPP I cannot dial. The message is that the modem is busy when I try to use the /dev/modem port. I tryed with two different chipsets models (both supported by the driver) in two different computers (one AMD Athlon 2600+ with 512Mb. RAM and another Athlon Thunderbird 900Mhz. with 128Mb. RAM). Can anybody help me with this? I can´t see where´s the problem. I tryed several times and the compilation process is always succesful but the problem is always the same. Thank U.

1 0

Callback and RAS
by Robert Krawczyk 22 Jul '04

22 Jul '04

Hi I have a WIN2K RAS Server at work with callback enabled. So when I make a connection to my work with my WinXP workstation, the RAS server recognises me and gives me an oppurtunity to be called back. And then the line is hung up and the RAS Server calls my workstation. But when i use PPP connection from my Fedora linux workstation connection is establish but without opportunity to be call back. What and how should i configure? any links, faq? Regards Robert

2 1

KISS firewall + iptables
by Jaider Viola - Deltaned 14 Jul '04

14 Jul '04

Hi, I try to install on my fedora core 2 server a KISS firewall. The firewall is installed without any problem but when I try to start the kiss firewall I get the follow: Since the ip_tables, ipt_state, and/or ipt_multiport modules do not exist, KISS can not function. Firewall script aborted! I do: chkconfig --list | grep -E "iptables|ipchains" and get the follow output: iptables 0:off 1:off 2:on 3:on 4:on 5:on 6:off Somebody have tips to get KISS working to secure my web machine? Thanks Jaider

2 1

HTML encoding
by Sulyok Peti 14 Jul '04

14 Jul '04

Does anybody know why are the generated HTML pages encoded to ISO-8859-1? I think UTF-8 would be better, because it is the default encoding in Fedora and GNOME2. Is it possible to change this setting without hacking xmlto? Peti

1 0

Schedule/priorities
by Paul W. Frields 14 Jul '04

14 Jul '04

Karsten, Since Tammy is currently out, would you like to step in and talk about projects that are either partly completed or need to be started, and in what order we might want to tackle them? We have a solid albeit small crew who, it seems, would probably like to start on some "real" FC documentation. (At least I hope so... the list has been rather quiet of late.) I would guess that a big part of that would be making some decisions on tutorials that are badly needed, rather than waiting for someone to walk in and suggest them. Some of my suggestions: - Installation guide? What's the status currently? Need help? - Setting up a local mirror for FTP/HTTP/NFS installation and system-intall-packages (yes, much of the former is in the anaconda docs, but it needs a more newbie-friendly home) - Setting up said mirror for provision of updates through up2date (as opposed to the manual yum/apt stuff) - General documentation of binutils and other command-line stuff for the masses (Done already in official RH docs, but we need new, clean-room versions for GFDL) Maybe my "targeting system" is a little off here. My interest lies in making Fedora Core accessible to Joe Newbie, while other people here might be particularly averse to that line of thinking. Back when I used Red Hat Linux, I always pointed people to the official Red Hat guides, because they were darn good, solid docs. They taught one to take advantage of the many nice ease-of-use facilities available in the distro, while still encouraging digging underneath if one were so inclined. I want people starting to use Fedora Core to have some of the same advantages I feel I had using Red Hat Linux, without having to resort to forking out a lot of cash to get a book that in large part goes over the same type of material. If anyone thinks I am way off base, say so. (You can't scare me, I'm a parent!) :-D -- Paul W. Frields, RHCE

3 2

Elements of Style and the documentation-guide
by Paul W. Frields 13 Jul '04

13 Jul '04

After spending the last several days doing markup on a syntactically and grammatically, er, "challenged" tutorial, I found myself in need of the solace of Strunk and White's "The Elements of Style," if only to remind myself that good writing does indeed exist outside my imagination. I noticed during my Web search that EoS was released some years ago into the public domain, and can be found in a variety of formats, although DocBook XML was not one of these as far as I can tell. I realize that "public domain" != "FDL," and therefore am wondering if anyone out there has sufficient expertise to address the extent to which EoS might be included in the documentation-guide. It would be a handy reference for contributors, so they might acquaint themselves with the way to write concisely before beginning a tutorial from scratch. It also would help editors (myself included) to make the right changes when presented with documentation that has been tortured and abused before a handoff. :-) In addition, or as an alternative, to EoS, perhaps there should be some guidelines that have been useful to the Red Hat staff in preparing their official RHL and RHEL documentation over the years. I have found those guides consistently clear, concise, and informative, and I would hope that FDP products would be of similar quality. By comparison, a lot of the documentation on the Web is poorly written, and often lapses into informalities, colloquialism, unhelpful jargon, and vague generalities. On the other hand, in many cases those materials will form the basis for future FDP work, so FDP content guidelines might be very useful as time goes on. (In the event that EoS can be included in the documentation-guide, I will volunteer to do markup, since I brought up the issue. I doubt it will be very difficult in any case, given that it's dominated by non-technical matter.) -- Paul W. Frields, RHCE

7 20

Tomcat
by Dave Pawson 08 Jul '04

08 Jul '04

Prowling around, I found: http://cymulacrum.net/writings/tomcat5/book1.html Very well written IMHO, and up to date. I should be getting the docbook source soon. I'll forward it to .... Tammy, hey come back we miss you :-) Karsten? Do you have CVS rights? regards DaveP

1 0

documentation request?
by Dave Pawson 04 Jul '04

04 Jul '04

Unsure even asking about this one. Tomcat is an apache project, sort of a browser on steroids. They've recently gone from 4.x to 5.0x, and the documentation has gone from fair to downright ..... poor. I've just spent two days trying to figure it out. Hoping there might be someone willing to help me throw a minimum document set together? Except.... tomcat isn't part of the Fedora core distro. Comments anyone? regards DaveP

3 7

doesn't reboot
by Christiaan Bos 02 Jul '04

02 Jul '04

Hello, I have installed Fedora Core 2 on a Compaq Proliant 1600. But it doesn't reboot. It stop sometimes by unmounting filesystem and sometimes it gives many bad character. and I must it reboot with the power button. As it have booted, it is a stable system. only I wanted it to reboot from my other computers. When i do it install, it don't go with the rest sometimes, and must I reboot with the power button. And I have to go with the begin. After the install, I have the keyboard unplugged. and it is now a stable system. I can do all with it, but only he doesn't reboot. Can anyone help me? Or can anyone tell me wat is the problem? Sorry for my bad english. Christiaan Bos _________________________________________________________________ MSN Zoeken helpt je om de gekste dingen te vinden! http://search.msn.nl

2 1

File System Check Error....HELP!!
by NeoAndersn007＠aol.com 02 Jul '04

02 Jul '04

hello, Im new here so if this has been asked before sorry but Ive tried everything else. I was trying to get my old harddrive, CD-Drive, and RAM stick in my computer running on Fedora Core 2. None of them worked and I had a terrible time getting my computer to even startup. After I got it to work it get me the following error which I can't figure out how to fix: fsck.ext3: Disk write-protected; Use the -n option to do a read-only check of the device. Read-only file system while trying to open /dev/hda2 *** An error occured during the file system check *** Dropping you to a shell; the system will reboot *** when you leave the shell Give root password for maintenance (or type Control-D to continue) (Repair filesystem) 1 # I have tried reconnecting everything, taking out my RAM and putting it back in, disconnecting power cord for long periods of time, re-installing fedora, and editing the bootup commands. nothing seems to be working, help!!!

2 1

Re: File System Check Error....HELP!!
by NeoAndersn007＠aol.com 02 Jul '04

02 Jul '04

ok thanks I hope i can get this figured out soon

1 0

2026

2025

2024

2023

2022

2021

2020

2019

2018

2017

2016

2015

2014

2013

2012

2011

2010

2009

2008

2007

2006

2005

2004

2003

2002

docs July 2004