docs October 2005

docs@lists.stg.fedoraproject.org

25 participants
35 discussions

FC5 test1 relnotes for translation
by Karsten Wade 25 Oct '05

25 Oct '05

Now ready in CVS, tagged as "FC-5-TEST1-TRANS-FREEZE". Someone here can correct me, but I believe you do this: echo $CVSROOT :ext:username@cvs.fedora.redhat.com:/cvs/docs cvs co -r FC-5-TEST1-TRANS-FREEZE -d release-notes-FC5test1 release notes Be sure to grab that tagged branch, as we will probably be adding to the HEAD (and tagging, eventually, as FC-5-TEST1-LATEST. cheers - 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 6

Re: XMLTO and SAXON
by Tommy Reynolds 25 Oct '05

25 Oct '05

Tim, I've attached my saxon patch, too. It adds a new command line switch (-X saxon) or (-X xsltproc), defaulting to what's in the ${XSLT_PROCESSOR} environment variable and if not set, to "xsltproc", as usual. Lemme know how this works out. All you FDP lot can just ignore these patches for now. I've CC'ed you just to let you know the patches have gone upstream. Cheers

1 0

RELEASE-NOTES-master-en.xml and README-en.xml
by Yuan Yijun 25 Oct '05

25 Oct '05

Should I translate RELEASE-NOTES-master-en.xml and README-en.xml even if they are not needed in build? They are so much out-of-date! :) -- bbbush ^_^

1 0

About release-notes, what should translators commit to cvs?
by Yuan Yijun 24 Oct '05

24 Oct '05

a single release-notes-xxx.xml file? or multiple xml files each in correspondence with an xml in the cvs? There are so many xml files which don't have a -en suffix in name. -- bbbush ^_^

2 1

Re: release-notes Makefile,1.1,1.2
by Karsten Wade 24 Oct '05

24 Oct '05

Tommy or Paul: Can you look at this change and give us a better way to do it? Or am I missing the existence of this functionality in Makefile.common? thx - Karsten On Mon, 2005-10-24 at 10:08 -0400, Karsten Wade wrote: > Author: kwade > > Update of /cvs/docs/release-notes > In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17937 > > Modified Files: > Makefile > Log Message: > Need to find a way to do this better, and I think it should be in the Makefile.common instead. However, my method here is obviously sub-par and throws an error, so I'll be punting for help. The objective is to make certain that the figs/ directory gets copied over to the HTML directories in all languages. Actually, the figs-/ needs to get copied to foo-/ HTML directory. This requires some consideration and kung-fu. It should copy over the language specific figures if they exist, otherwise use the English by default so as to not break the build. > > > Index: Makefile > =================================================================== > RCS file: /cvs/docs/release-notes/Makefile,v > retrieving revision 1.1 > retrieving revision 1.2 > diff -u -r1.1 -r1.2 > --- Makefile 24 Oct 2005 13:13:33 -0000 1.1 > +++ Makefile 24 Oct 2005 14:08:53 -0000 1.2 > @@ -1,90 +1,100 @@ > -LANG = en > -DOCS_SETUP_PATH= ../../docs-common > -XSLPDF = $(DOCS_SETUP_PATH)/xsl/main-pdf.xsl > -XSLHTML = $(DOCS_SETUP_PATH)/xsl/main-html-nochunks-relnotes.xsl > - > -XSLPDFCOMMONS = ${XSLPDF} > -XSLHTMLCOMMONS = ${XSLHTML} > - > -XMLCOMMONSPATH=${DOCS_SETUP_PATH}/common > -XMLCOMMONS=${XMLCOMMONSPATH}/cvs-en.xml \ > - ${XMLCOMMONSPATH}/draftnotice-en.xml \ > - ${XMLCOMMONSPATH}/fedora-entities-en.ent \ > - ${XMLCOMMONSPATH}/fedora-entities-en.xml \ > - ${XMLCOMMONSPATH}/legacynotice-en.xml \ > - ${XMLCOMMONSPATH}/legalnotice-en.xml \ > - ${XMLCOMMONSPATH}/obsoletenotice-en.xml > - > -.SUFFIXES: > -.SUFFIXES: .html .pdf .xml > - > -all: README-${LANG}.html \ > - RELEASE-NOTES-${LANG}.html \ > - RELEASE-NOTES-${LANG}.txt \ > - README-${LANG}.txt > - > -#README-${LANG}.pdf RELEASE-NOTES-${LANG}.pdf > - > -%.pdf: %.xml > - xmlto pdf -x ${XSLPDF} $< > - > -%.html: %.xml > - ${RM} -r ${@:.html=} > - xmlto html -x ${XSLHTML} -o ${@:.html=} $< > - mkdir -p ${@:.html=}/stylesheet-images > - mkdir -p ${@:.html=}/figs > - cp $(DOCS_SETUP_PATH)/stylesheet-images/*.png ${@:.html=}/stylesheet-images > - cp ./figs/*.png ${@:.html=}/figs > - cp $(DOCS_SETUP_PATH)/css/fedora.css ${@:.html=} > - mv ${@:.html=}/${@:.html=.proc} ${@:.html=}/$@ > - ln -sf ${@:.html=}/$@ $@ > - > -%.txt: %.xml > - xmlto txt $< > -# mv $@ RELEASE-NOTES-${LANG} > - > -# FIXME eula.txt: eula.py > -# FIXME python -c "import py_compile; py_compile.compile('eula.py')" > - > -# Note: keep "RELEASE-NOTES-en.xml" first, for now. > - > -RNFILES=RELEASE-NOTES-en.xml daemons.xml database-servers.xml \ > - desktop.xml development-tools.xml feedback.xml file-servers.xml \ > - file-systems.xml hardware-reqs.xml install-notes.xml intro.xml \ > - java-package.xml kernel.xml misc-server.xml multimedia.xml \ > - networking.xml overview.xml package-movement.xml \ > - package-notes.xml printing.xml project-overview.xml samba.xml \ > - security.xml server-tools.xml splash.xml web-servers.xml \ > - xorg.xml > - > -# README-${LANG}.pdf: README-en.xml > -# README-${LANG}.html: README-en.xml > -RELEASE-NOTES-${LANG}.pdf: ${RNFILES} ${XMLCOMMONS} ${XSLPDFCOMMONS} > -RELEASE-NOTES-${LANG}.html: ${RNFILES} ${XMLCOMMONS} ${XSLHTMLCOMMONS} > -RELEASE-NOTES-${LANG}.txt: ${RNFILES} ${XMLCOMMONS} > - > -clean: > - ${RM} ChangeLog ChangeLog.xml > - > -distclean clobber: clean > - ${RM} ChangeLog-${LANG}.html ChangeLog.txt > - ${RM} -r README-${LANG}.pdf README-${LANG}.html README-${LANG}.txt > - ${RM} -r RELEASE-NOTES-${LANG}.pdf RELEASE-NOTES-${LANG}.html \ > - RELEASE-NOTES-${LANG} RELEASE-NOTES-${LANG}.txt > - > -# If you have the "cvs2cl" package installed, then you can make > -# fancy HTML ChangeLogs > - > -ChangeLogs: > - ${RM} ChangeLog* > - ${MAKE} ChangeLog.txt > - ${MAKE} ChangeLog-${LANG}.html > - > -ChangeLog.txt: > - LANG=C cvs2cl -f ChangeLog.txt > - > -ChangeLog.xml: > - LANG=C cvs2cl --xml --xml-encoding UTF-8 -f ChangeLog.xml > - > -ChangeLog-${LANG}.html: ChangeLog.xml > - xsltproc -o $@ /usr/share/xml/cvs2cl/cl2html.xslt $< > +############################################################################### > +# Makefile for RHLP docs project > +# Created by: Tammy Fox <tfox(a)redhat.com> > +# Last edited by: Tommy Reynolds <Tommy.Reynolds(a)MegaCoder.com> > +# WARNING: need passivetex 1.24 for pdf generation to work > +# License: GPL > +# Copyright 2003 Tammy Fox, Red Hat, Inc. > +# Copyright 2005 Tommy Reynolds, MegaCoder.com > +############################################################################### > +# > +# Document-specific definitions. > +# > +LANGUAGES = en > +DOCBASE = RELEASE-NOTES > +XMLEXTRAFILES-en=daemons.xml database-servers.xml desktop.xml development-tools.xml feedback.xml file-servers.xml file-systems.xml hardware-reqs.xml install-notes.xml intro.xml java-package.xml kernel.xml misc-server.xml multimedia.xml networking.xml overview.xml package-movement.xml package-notes.xml printing.xml project-overview.xml samba.xml security.xml server-tools.xml splash.xml web-servers.xml xorg.xml > +# > +###################################################### > +include ../docs-common/Makefile.common > +###################################################### > +# > +# If you want to add additional steps to any of the > +# targets defined in "Makefile.common", be sure to use > +# a double-colon in your rule here. For example, to > +# print the message "FINISHED AT LAST" after building > +# the HTML document version, uncomment the following > +# line: > +#${DOCBASE}-en/index.html:: > +# echo FINISHED AT LAST > + > +# Need to copy over the figures for this directory. Should > +# this be a common action instead? > +${DOCBASE}-en/index.html:: > + mkdir -p ${DOCBASE}-${LANGUAGES}/figs > + cp figs/* ${DOCBASE}-${LANGUAGES}/figs > + > +###################################################### > +# Some packaging specific vars > +VERSION=$(shell grep BOOKID $(DOCBASE)-en.xml | sed 's/<!ENTITY BOOKID "[^0-9\.]\+//' | sed 's/ .\+//') > +DATE=${shell grep BOOKID $(DOCBASE)-en.xml | sed 's/.\+(//' | sed 's/).\+//' } > +NOW=$(shell date +"%a %b %e %Y") > +SPECIN=../docs-common/packaging/fedora-doc.spec.in.common > +OMFIN=../docs-common/packaging/fedora-doc.omf.in.common > +DESKTOPIN=../docs-common/packaging/fedora-doc.desktop.in.common > +DOCSPEC=$(PWD)/SPECS/$(DOCBASE).spec > +DOCOMF=$(PWD)/SOURCES/fedora-doc-$(DOCBASE)-C.omf > +DOCDESKTOP=$(PWD)/SOURCES/fedora-doc-$(DOCBASE).desktop > +DOCSRCTAR=$(PWD)/SOURCES/$(DOCBASE)-$(VERSION).src.tar.gz > +TITLE=$(shell ../docs-common/packaging/titlegrab.py $(DOCBASE)-en.xml | sed 's/^ \+//') > +###################################################### > +# Some RPM flags... > +###################################################### > +RPMFLAGS=--define "docbase $(DOCBASE)" --define "version $(VERSION)" --define "_topdir $(PWD)" > +###################################################### > + > + > +clean:: > + rm -rf fedora-doc-$(DOCBASE)*.rpm > + > + > +rpm: clean > +# > +# Make RPM-compliant tarball of source XML and other stuff > + mkdir $(DOCBASE)-$(VERSION) > + find . -maxdepth 1 -type f ! $ -name '*~' -o -name 'Makefile*' $ \ > + | cpio -pamdv $(DOCBASE)-$(VERSION) > + find . -maxdepth 1 -type d ! $ -name '$(DOCBASE)-$(VERSION)' \ > + -o -name 'CVS' -o -name '*~' -o -name '$(DOCBASE)*' $ \ > + | cpio -pamdv $(DOCBASE)-$(VERSION) > +# > +# Make RPM build tree; don't rely on local user's setup > + mkdir -p {BUILD,RPMS/noarch,SOURCES,SPECS,SRPMS} > + tar -zcvf $(DOCSRCTAR) $(DOCBASE)-$(VERSION) > + rm -rf $(DOCBASE)-$(VERSION)/ > +# > +# Make rpmlint happy with a changelog entry > +# FIXME: Maybe more magic would make this stickier; pity > +# I'm no magician... > + sed 's/$%changelog$/\1\n* $(NOW) Fedora Docs Project <fedora-docs-list(a)redhat.com> - $(VERSION)-1\n- Update to version $(VERSION)\n/' \ > + $(SPECIN) > $(DOCSPEC) > +# > +# Fill in files > +# FIXME: Needs to be multiplexed for LANGUAGES (see above) > + cp $(OMFIN) $(DOCOMF) > + cp $(DESKTOPIN) $(DOCDESKTOP) > + sed -i 's/@VERSION@/$(VERSION)/g' $(DOCOMF) > + sed -i 's/@DATE@/$(DATE)/g' $(DOCOMF) > + sed -i 's/@TITLE@/$(TITLE)/g' $(DOCOMF) > + sed -i 's/@DOCBASE@/$(DOCBASE)/g' $(DOCOMF) > + sed -i 's/@VERSION@/$(VERSION)/g' $(DOCDESKTOP) > + sed -i 's/@DATE@/$(DATE)/g' $(DOCDESKTOP) > + sed -i 's/@TITLE@/$(TITLE)/g' $(DOCDESKTOP) > + sed -i 's/@DOCBASE@/$(DOCBASE)/g' $(DOCDESKTOP) > +# > +# Do the build... > +# > + rpmbuild -bb $(RPMFLAGS) $(DOCSPEC) > + mv RPMS/noarch/*.rpm . > + rpmbuild --clean --rmsource $(RPMFLAGS) $(DOCSPEC) > + rm -rf {BUILD,RPMS,SOURCES,SPECS,SRPMS} > + rm -rf $(DOCBASE)-$(VERSION) > > -- > Fedora-docs-commits mailing list > Fedora-docs-commits(a)redhat.com > https://www.redhat.com/mailman/listinfo/fedora-docs-commits -- 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/

3 2

invitation to hack the relnotes tonight
by Karsten Wade 24 Oct '05

24 Oct '05

I was unable to work on the relnotes this weekend, and we have had a temporary staffing shortage for the release notes team. For both of these reasons, I have extended the freeze for translation by seven hours, to give me time to sweep the relnotes together for trans for FC5 test1. Highlights: * Patrick did some tricky coolness to get us Wiki > XML, gracias * First pull from Wiki beats into relnotes * New structure in CVS If you are interested in this, I'll be on #fedora-docs working on this starting after Midnight UTC (25 October). - 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/

1 0

establishing a timezone for FDP
by Karsten Wade 24 Oct '05

24 Oct '05

There are two reasons I use Eastern Daylight/Standard time: * That is where the QA and release engineering teams for Fedora are primarily based. Working off a schedule that is intuitive for them reduces the chances of miscommunication and mistakes. * The same intuitiveness is currently spread throughout the Fedora development community. Should this change, or we want to lead a charge for UTC on all things, feel free to challenge this concept. Meanwhile, if we ever set a deadline, e.g. 24 October, this is what it means: 24 October 23:59 Eastern Time Yes, that means right before Midnight. This way we provide the most time for completing deadlines without having confusion about Midnight meaning the start of the end of which day. Alternately, we can set deadlines as COB (close of business), for an additional cushion of time. That would be: 24 October 17:00 Easter Time Does this make sense? When doing the scheduling for translation, I tried to add in a calendar day as a cushion against any problems caused by a deadline being late afternoon in APAC. http://fedoraproject.org/wiki/DocsProject/Schedule - 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/

4 5

Self-Introduction: Yuan Yijun
by Yuan Yijun 23 Oct '05

23 Oct '05

Name: Yuan Yijun (袁乙钧, in Chinese) City & Country: Shenzhen, Guangdong, China (tz: +0800) Profession: Programmer Company: Morningstar, Inc. Your goals in the Fedora Project - I want to help document translation. I want to see more Chinese documents in fedora. Historical qualifications - I contributed some translations to Chinese Man Page Project (http://cmpp.linuxforum.net ), include bash.1, etc. - I'm working on http://fedora.gro.clinux.org Computer skills - I'm a linux user since redhat 7.3. - I will become a excellent c++ programmer. GPG KEYID and fingerprint pub 1024D/83349285 2005-10-22 [expires: 2007-01-01] Key fingerprint = DCCE E98A DBBC 71F6 57D8 C2BA CF7A 52BD 8334 9285 uid Yuan Yijun (bbbush) <bbbush.yuan(a)gmail.com> sub 2048g/CDB2236B 2005-10-22 [expires: 2007-01-01] -- bbbush ^_^

2 4

Self-Introduction: Hrishikesh Ballal
by Hrishikesh Ballal 21 Oct '05

21 Oct '05

Name: Hrishikesh Ballal Location: Eastern Time Zone, USA Profession: Process Specialist Your goals in the Fedora Project I wish to contribute to the web / infrastructure team. I have intermediate coding skills and am looking to contribute with the website and other web related backend systems. Historical qualifications What other projects or writing have you worked on in the past? - I have worked on the new design on www.fedoraproject.org website, wiki and other components of the website including Fedora Accounts System. - I have worked with Yumex with some documentation and am currently helping the project with testing and optimization. - I am currently working on www.fedoratracker.org Anything else special? Nope. Everything else is at http://www.hrishikeshballal.net/ http://www.fedoraproject.org/wiki/HrishikeshBallal What level and type of computer skills do you have? As far as Fedora is concerned, I have intermediate coding skills in Python, PHP, SQL. What other skills do you have that might be applicable? User interface design, other so-called soft skills (people skills), programming, etc. I have project management and project planning skills. Professionally, I am involved in optimizing IT systems and processes. I have experience in process control, optimization and feedback systems. GPG KeyID and Fingerprint pub 1024D/DECEE55D 2005-06-16 Key fingerprint = D2F7 2117 6C27 519A 3FA3 A2C5 5934 5083 DECE E55D uid Hrishikesh Ballal <hballal(a)gmail.com> sub 1024g/CE27A608 2005-06-16

1 0

Fedora web team
by Elliot Lee 21 Oct '05

21 Oct '05

Hey all, It seems like there are at least a few people who are interested in reworking the Fedora web site. I think it would be good to have more coordination on our efforts. So, please visit: http://fedoraproject.org/wiki/Fedora/Web and let's all get together and figure things out. This may just be my way of catching up with everyone else who is already working nicely together - please bring me up to speed. :) Best, -- Elliot

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 October 2005