From fedora-docs-commits at redhat.com Wed Jun 1 00:02:37 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Tue, 31 May 2005 20:02:37 -0400 Subject: release-notes/FC4 java.xml,1.2,1.3 package-notes.xml,1.14,1.15 Message-ID: <200506010002.j5102bCF013503@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13494 Modified Files: java.xml package-notes.xml Log Message: Java recommendations courtesy of bz#159179. Index: java.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/java.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- java.xml 28 May 2005 16:10:31 -0000 1.2 +++ java.xml 1 Jun 2005 00:02:35 -0000 1.3 @@ -1,3 +1,19 @@ +
+ Java Package Recommendations + + &FC; &LOCALVER; users are advised not to use the Java RPM provided + by Sun. It contains Provides that + conflict with names used in packages provided as part of &FC; + &LOCALVER;. Because of this, Sun Java might disappear from an + installed system during package upgrade operations. + + + &FC; &LOCALVER; users should use either the RPM from jpackage.org or + manually install the Sun Java tarball into + /opt. Sun Java 1.5+ is recommended for + stability purposes. + +
Packages Moved to &FEX; + + These are some of the packages that have moved from &CORE; to + &FEX;. These are active packages that are maintained and + supported by the &FP;. If you are looking for information about + &EX;, refer to this URL: + + + http://fedoraproject.org/wiki/Extras + + + List is Incomplete + + This list highlights some of the major packages that moved from + &CORE; to &EX; between &FC; 3 and &FC; &LOCALVER;. This is not + a complete list. + + @@ -19,6 +37,11 @@ + balsa + + + + bzflag @@ -84,6 +107,11 @@ + libtabe + + + + libxfce4mcs @@ -99,6 +127,11 @@ + Maelstrom + + + + ncftp @@ -109,6 +142,26 @@ + recode + + + + + SDL_image + + + + + SDL_mixer + + + + + SDL_net + + + + sylpheed @@ -119,6 +172,11 @@ + xboard + + + + xcin From fedora-docs-commits at redhat.com Wed Jun 1 01:28:08 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Tue, 31 May 2005 21:28:08 -0400 Subject: release-notes/FC4 RELEASE-NOTES-en.xml,1.6,1.7 intro.xml,1.4,1.5 Message-ID: <200506010128.j511S86j014876@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14867 Modified Files: RELEASE-NOTES-en.xml intro.xml Log Message: Adding a real BUG-URL and a handy TINY-BUG-URL for the print version. Ugly but useful. Index: RELEASE-NOTES-en.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/RELEASE-NOTES-en.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- RELEASE-NOTES-en.xml 31 May 2005 02:30:17 -0000 1.6 +++ RELEASE-NOTES-en.xml 1 Jun 2005 01:28:06 -0000 1.7 @@ -40,12 +40,14 @@ - - + + + + ]>
Index: intro.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/intro.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- intro.xml 30 May 2005 20:46:12 -0000 1.4 +++ intro.xml 1 Jun 2005 01:28:06 -0000 1.5 @@ -25,6 +25,20 @@ url="http://fedora.redhat.com/docs/release-notes/">http://fedora.redhat.com/docs/release-notes/. Users are advised to check this link regularly for updates. + + For reporting errors or other requests about these release notes, + file a bug report using this pre-filled bugzilla template: + + + &BUG-URL; + + + This &TINY-BUG-URL; will + take you to the same pre-filled bugzilla template. +
+ From fedora-docs-commits at redhat.com Thu Jun 2 12:58:19 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Thu, 2 Jun 2005 08:58:19 -0400 Subject: mirror-tutorial mirror-tutorial-en.xml,1.2,1.3 Message-ID: <200506021258.j52CwJ5q029417@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/mirror-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv29402 Modified Files: mirror-tutorial-en.xml Log Message: Updated entities pointer Index: mirror-tutorial-en.xml =================================================================== RCS file: /cvs/docs/mirror-tutorial/mirror-tutorial-en.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- mirror-tutorial-en.xml 18 May 2005 02:00:40 -0000 1.2 +++ mirror-tutorial-en.xml 2 Jun 2005 12:58:17 -0000 1.3 @@ -2,7 +2,7 @@ + %FEDORA-ENTITIES-EN; From fedora-docs-commits at redhat.com Thu Jun 2 17:58:02 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Thu, 2 Jun 2005 13:58:02 -0400 Subject: xsl main-html.xsl,1.3,1.4 redhat.xsl,1.2,1.3 Message-ID: <200506021758.j52Hw2rb003942@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/xsl In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv3925 Modified Files: main-html.xsl redhat.xsl Log Message: This solves the regression for users of main-html.xsl. We'll deprecate that and the redhat.xsl that imports docbook.xsl sometime in the week of 8 June. Index: main-html.xsl =================================================================== RCS file: /cvs/docs/xsl/main-html.xsl,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- main-html.xsl 12 Aug 2004 19:47:03 -0000 1.3 +++ main-html.xsl 2 Jun 2005 17:57:59 -0000 1.4 @@ -7,6 +7,7 @@ version="1.0" exclude-result-prefixes="exsl"> + Index: redhat.xsl =================================================================== RCS file: /cvs/docs/xsl/redhat.xsl,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- redhat.xsl 1 Jun 2005 23:58:27 -0000 1.2 +++ redhat.xsl 2 Jun 2005 17:57:59 -0000 1.3 @@ -7,8 +7,6 @@ version="1.0" exclude-result-prefixes="exsl"> - - From fedora-docs-commits at redhat.com Thu Jun 2 18:23:19 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Thu, 2 Jun 2005 14:23:19 -0400 Subject: xsl main-html-nochunks-relnotes.xsl, NONE, 1.1 html-common.xsl, 1.7, 1.8 Message-ID: <200506021823.j52INJH8005084@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/xsl In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv5068 Modified Files: html-common.xsl Added Files: main-html-nochunks-relnotes.xsl Log Message: The release notes needs it's own XSL for makign it literally and entirely one single document, legalnotice included. --- NEW FILE main-html-nochunks-relnotes.xsl --- 3 book toc,title,figure,table,example,equation article toc chapter nop qandadiv toc qandaset toc sect1 nop sect2 nop sect3 nop sect4 nop sect5 nop section nop Index: html-common.xsl =================================================================== RCS file: /cvs/docs/xsl/html-common.xsl,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- html-common.xsl 30 May 2005 20:01:11 -0000 1.7 +++ html-common.xsl 2 Jun 2005 18:23:16 -0000 1.8 @@ -25,10 +25,7 @@ - text/css From fedora-docs-commits at redhat.com Thu Jun 2 18:23:50 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Thu, 2 Jun 2005 14:23:50 -0400 Subject: xsl html-common-relnotes.xsl,NONE,1.1 Message-ID: <200506021823.j52INog8005109@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/xsl In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv5095 Added Files: html-common-relnotes.xsl Log Message: Part of making the relnotes have it's own XSL. --- NEW FILE html-common-relnotes.xsl --- ./stylesheet-images/ ./stylesheet-images/ figure after example after equation after table after procedure after text/css From fedora-docs-commits at redhat.com Thu Jun 2 18:24:26 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Thu, 2 Jun 2005 14:24:26 -0400 Subject: release-notes/FC4 Makefile,1.13,1.14 Message-ID: <200506021824.j52IOQav005131@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv5116 Modified Files: Makefile Log Message: Relnotes is a special case, with a special Makefile, and now a special XSL. Oh, well, works for now. Index: Makefile =================================================================== RCS file: /cvs/docs/release-notes/FC4/Makefile,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- Makefile 31 May 2005 04:57:40 -0000 1.13 +++ Makefile 2 Jun 2005 18:24:24 -0000 1.14 @@ -1,7 +1,7 @@ LANG = en DOCS_SETUP_PATH= ../.. XSLPDF = $(DOCS_SETUP_PATH)/xsl/main-pdf.xsl -XSLHTML = $(DOCS_SETUP_PATH)/xsl/main-html-nochunks.xsl +XSLHTML = $(DOCS_SETUP_PATH)/xsl/main-html-nochunks-relnotes.xsl XSLPDFCOMMONS = ${XSLPDF} XSLHTMLCOMMONS = ${XSLHTML} From fedora-docs-commits at redhat.com Fri Jun 3 03:43:11 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Thu, 2 Jun 2005 23:43:11 -0400 Subject: common legalnotice-content-en.xml, NONE, 1.1 legalnotice-relnotes-en.xml, NONE, 1.1 fedora-entities-en.ent, 1.2, 1.3 legalnotice-en.xml, 1.8, 1.9 Message-ID: <200506030343.j533hBhm017054@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17035 Modified Files: fedora-entities-en.ent legalnotice-en.xml Added Files: legalnotice-content-en.xml legalnotice-relnotes-en.xml Log Message: This is just a little hackish. With the legalnotice inline, it ruined the effect of the new release notes style and what's new content. These changes, plus changes to the relnotes parent, pull a special relnotes legalnotice in that has a single sentence and links to an appendix with the full legalnotice content. This is not semantically correct, there must be a way to handle this in the XSL so that the legalnotice content is properly contained throughout. This hack can stand until I find the XSL fix, because sometimes Pretty is more important than Right. --- NEW FILE legalnotice-content-en.xml --- Permission is granted to copy, distribute, and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is available at http://www.gnu.org/licenses/fdl.html. This document may be copied and distributed in any medium, either commercially or noncommercially, provided that the GNU Free Documentation License (FDL), the copyright notices, and the license notice saying the GNU FDL applies to the document are reproduced in all copies, and that you add no other conditions whatsoever to those of the GNU FDL. Garrett LeSage created the admonition graphics (note, tip, important, caution, and warning). Tommy Reynolds Tommy.Reynolds at MegaCoder.com created the callout graphics. They all may be freely redistributed with documentation produced for the &PROJECT;. &BOOKID; &RH;, &RH; Network, the &RH; "Shadow Man" logo, RPM, Maximum RPM, the RPM logo, Linux Library, PowerTools, Linux Undercover, RHmember, RHmember More, Rough Cuts, Rawhide and all &RH;-based trademarks and logos are trademarks or registered trademarks of &FORMAL-RHI; in the United States and other countries. Linux is a registered trademark of Linus Torvalds. Motif and UNIX are registered trademarks of The Open Group. Intel and Pentium are registered trademarks of Intel Corporation. Itanium and Celeron are trademarks of Intel Corporation. AMD, AMD Athlon, AMD Duron, and AMD K6 are trademarks of Advanced Micro Devices, Inc. Windows is a registered trademark of Microsoft Corporation. SSH and Secure Shell are trademarks of SSH Communications Security, Inc. FireWire is a trademark of Apple Computer Corporation. All other trademarks and copyrights referred to are the property of their respective owners. --- NEW FILE legalnotice-relnotes-en.xml --- This document is released under the terms of the GNU Free Documentation License. For more details, read the full legalnotice in . Index: fedora-entities-en.ent =================================================================== RCS file: /cvs/docs/common/fedora-entities-en.ent,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- fedora-entities-en.ent 31 May 2005 23:49:51 -0000 1.2 +++ fedora-entities-en.ent 3 Jun 2005 03:43:08 -0000 1.3 @@ -45,6 +45,8 @@ + + Index: legalnotice-en.xml =================================================================== RCS file: /cvs/docs/common/legalnotice-en.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- legalnotice-en.xml 30 May 2005 20:30:27 -0000 1.8 +++ legalnotice-en.xml 3 Jun 2005 03:43:08 -0000 1.9 @@ -8,76 +8,5 @@ ]> --> - - - Permission is granted to copy, distribute, and/or modify this document under - the terms of the GNU Free Documentation License, Version 1.2 or any later - version published by the Free Software Foundation; with no Invariant - Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the - license is available at http://www.gnu.org/licenses/fdl.html. - - - - This document may be copied and distributed in any medium, either - commercially or noncommercially, provided that the GNU Free Documentation - License (FDL), the copyright notices, and the license notice saying the GNU - FDL applies to the document are reproduced in all copies, and that you add - no other conditions whatsoever to those of the GNU FDL. - - - - Garrett LeSage created the admonition graphics (note, tip, important, - caution, and warning). - Tommy Reynolds Tommy.Reynolds at MegaCoder.com created the callout graphics. - They all may be freely redistributed with documentation - produced for the &PROJECT;. - - - - &BOOKID; - - - - &RH;, &RH; Network, the &RH; "Shadow Man" logo, RPM, Maximum RPM, the RPM logo, Linux - Library, PowerTools, Linux Undercover, RHmember, RHmember More, Rough Cuts, - Rawhide and all &RH;-based trademarks and logos are trademarks or registered - trademarks of &FORMAL-RHI; in the United States and other countries. - - - - Linux is a registered trademark of Linus Torvalds. - - - - Motif and UNIX are registered trademarks of The Open Group. - - - - Intel and Pentium are registered trademarks of Intel Corporation. Itanium - and Celeron are trademarks of Intel Corporation. - - - - AMD, AMD Athlon, AMD Duron, and AMD K6 are trademarks of Advanced Micro - Devices, Inc. - - - - Windows is a registered trademark of Microsoft Corporation. - - - - SSH and Secure Shell are trademarks of SSH Communications Security, Inc. - - - - FireWire is a trademark of Apple Computer Corporation. - - - - All other trademarks and copyrights referred to are the property of their - respective owners. - - +&LEGALNOTICE-CONTENT; From fedora-docs-commits at redhat.com Fri Jun 3 03:44:07 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Thu, 2 Jun 2005 23:44:07 -0400 Subject: release-notes/FC4 RELEASE-NOTES-en.xml,1.7,1.8 Message-ID: <200506030344.j533i7xq017075@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17060 Modified Files: RELEASE-NOTES-en.xml Log Message: These changes support the hackish moving of the legalnotice contents to the end of the file, which is the bottom of the no chunks output. This way the ugly legalnotice doesn't lead the document, except for a single sentecne and link to more. Index: RELEASE-NOTES-en.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/RELEASE-NOTES-en.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- RELEASE-NOTES-en.xml 1 Jun 2005 01:28:06 -0000 1.7 +++ RELEASE-NOTES-en.xml 3 Jun 2005 03:44:05 -0000 1.8 @@ -50,15 +50,17 @@ ]> -
+ +
&DISTRO; &DISTROVER; Release Notes 2005 &FORMAL-RHI; - &LEGALNOTICE; + &LEGALNOTICE-RELNOTES; + &SPLASH; @@ -75,4 +77,8 @@ x86_64 ) --> + + Legalnotice + &LEGALNOTICE-CONTENT; +
From fedora-docs-commits at redhat.com Fri Jun 3 04:06:07 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Fri, 3 Jun 2005 00:06:07 -0400 Subject: common README,NONE,1.1 Message-ID: <200506030406.j534675m018131@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18117 Added Files: README Log Message: Starting to get crowded in common/, needed a little explanation of the assets. --- NEW FILE README --- This README explains the relationship of the files in /cvs/docs/common/. This is specific to the Fedora Documentation Project (FDP). cvs-en.xml Generic chapter explaining what CVS is and how to use it. Used in Developer Guide. draftnotice-en.xml Used when a document is in draft/beta stage. This is usually put at the very top of the parent XML file so that it is the first thing read. Calls to this entity are removed when the document is moved to a live status. This prevents confusion in thinking a beta document is the genuine document. fedora-entities-en.ent DocBook entities are declared in this file. All entities that are even remotely common across FDP should have an entity in this file. fedora-entities-en.xml - DEPRECATED This file served the same as fedora-entities-en.xml but is deprecated due to an inaccurate file extension. legacynotice-en.xml This entity is called from a document that relates to a specific version of Fedora Core that is moving from the Fedora Project to the Fedora Legacy Project for management and maintenance. legalnotice-content-en.xml This is the actual content of the legalnotice. Change content here to propagate to all systems. legalnotice-en.xml This is the common call of the legalnotice material, used in the and appearing as a link above the ToC, or directly inline if the XSL linking is disabled. The release notes use inline legalnotice, so have a different common file. legalnotice-relnotes-en.xml This is called by only the release notes. It contains a single reference to the GFDL, and an to the that has a call to the actual content from legalnotice-content-en.xml. This keeps the inline usage of the legalnotice from overwhelming the layout. NOTE: this is a sematic hack and should be fixed by changes to the XSL. obsoletenotice-en.xml Used for documents that are for a version of Fedora Core that is no longer supported by the Fedora Project and is not being maintained by the Fedora Legacy Project. Documents with this notice are no longer being maintained. From fedora-docs-commits at redhat.com Fri Jun 3 22:34:26 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Fri, 3 Jun 2005 18:34:26 -0400 Subject: release-notes/FC4/figs Fedora_Desktop.eps, 1.1, 1.2 Fedora_Desktop.png, 1.1, 1.2 Message-ID: <200506032234.j53MYQ1U012685@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4/figs In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12658/figs Modified Files: Fedora_Desktop.eps Fedora_Desktop.png Log Message: Images were a wee bit too big. This is closer to what our style guidelines should want. View full diff with command: /usr/bin/cvs -f diff -kk -u -N -r 1.1 -r 1.2 Fedora_Desktop.eps Index: Fedora_Desktop.eps =================================================================== RCS file: /cvs/docs/release-notes/FC4/figs/Fedora_Desktop.eps,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- Fedora_Desktop.eps 30 May 2005 16:13:39 -0000 1.1 +++ Fedora_Desktop.eps 3 Jun 2005 22:34:23 -0000 1.2 @@ -1,9 +1,9 @@ %!PS-Adobe-3.0 EPSF-3.0 %%Creator: (ImageMagick) %%Title: (Fedora_Desktop.eps) -%%CreationDate: (Mon May 30 09:07:28 2005) -%%BoundingBox: 0 0 288 216 -%%HiResBoundingBox: 0 0 288 216 +%%CreationDate: (Fri Jun 3 15:31:48 2005) +%%BoundingBox: 0 0 113 85 +%%HiResBoundingBox: 0 0 113.386 85 %%DocumentData: Clean7Bit %%LanguageLevel: 1 %%Pages: 1 @@ -263,13 +263,13 @@ } bind def %%EndProlog %%Page: 1 1 -%%PageBoundingBox: 0 0 288 216 +%%PageBoundingBox: 0 0 113 85 userdict begin DisplayImage 0 0 -288 216 +113.386 85.0394 12.000000 -800 600 +500 375 0 0 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 @@ -312,101 +312,6 @@ EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EEEAE6EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EEEAE6EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EEEAE6EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EEEAE6EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EEEAE6EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EEEAE6EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 @@ -420,6 +325,12 @@ EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 +EFEBE7EFEBE7EFEBE7EDE9E5DDDAD6D9D5D1DAD6D2E5E1DDEEEAE6EFEBE7EFEBE7EFEBE7 +EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EBE8E4EFEBE7 +EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EDE9E5E8E4E0E4E0DCE0DCD9DAD7D3 +D8D4D0D4D1CDE7E3E0EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 +EFEBE7EFEBE7E8E5E1E5E1DDEEEAE6EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 +ECE8E5D6D2CFD1CECAD1CECAD1CECAD1CECAD1CECAD1CECAD1CECAD1CECADBD7D3EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 @@ -432,8 +343,10 @@ EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 +EFEBE7EAE6E1E8E4DFEBE8E1DDDAD3EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 +EFEBE7EFEBE7E5DFD9D3CBC3D3CBC3ECE7E2EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 @@ -441,202 +354,25 @@ EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7C0B5A9C0B5A9C0B5A9C0B5A9EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EEEAE6 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EEEAE6EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EEEAE6EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 [...52622 lines suppressed...] E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 +E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD5D6CFC9D0C9C4E0D9D3E3DCD6E3DCD6E3DCD6 +E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD5E3DCD5E3DCD6E3DCD6 +E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6DCD5CFE2DBD4E3DCD6E3DCD6E3DCD6E3DCD6 E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6E3DCD6 -E2DBD49E908378716BC0B5A9C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC +E3DCD6E3DCD6C3BAB0999189BBB3ABC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC @@ -40103,101 +15836,7 @@ C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BC -78716BEFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7D7D1CA9F9284E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -9F9284D7D1CAEFEBE7EFEBE7EFEBE7C0B5A9C0B5A9C0B5A9C0B5A9EFEBE7EFEBE7EFEBE7 -D7D1CA9F9284E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4 -E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD4E2DBD49F9284D7D1CACCC7C278726B -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB -C7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BBC7C1BB78726BCCC7C2EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 +C8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC8C2BCC5BFB9A19A94E3DEDAEFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 @@ -40205,44 +15844,6 @@ EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7D7D1CA9F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F9284D7D1CAEFEBE7EFEBE7EFEBE7 -EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7D7D1CA9F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F92849F9284 -9F92849F92849F92849F9284D7D1CAEFEBE7EFEBE7CCC7C278726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B78726B -78726B78726B78726BCCC7C2EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 @@ -40254,6 +15855,30 @@ EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 +EFEBE7EFEBE7EFEBE7EFEBE7D9D2CBBBB0A5B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2BDB3A9E4DFD9EFEBE7 +E8E3DEDDD7D0DDD7D0EDE8E4EFEBE7D9D2CBBBB0A5B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2 +B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2B8ADA2D0C8C0DCD8D3 +A19B95969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +969089969089969089969089969089969089969089969089969089969089969089969089 +96908996908996908996908998938CC7C2BDEDE9E5EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7EFEBE7 From fedora-docs-commits at redhat.com Sun Jun 5 13:19:42 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Sun, 5 Jun 2005 09:19:42 -0400 Subject: desktop-up2date - Imported sources Message-ID: <200506051319.j55DJgX1000481@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/desktop-up2date In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv467 Log Message: Initial CVS import. Status: Vendor Tag: elliss Release Tags: Initial N desktop-up2date/desktop-up2date-en.xml N desktop-up2date/Makefile No conflicts created by this import From fedora-docs-commits at redhat.com Tue Jun 7 08:23:42 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Tue, 7 Jun 2005 04:23:42 -0400 Subject: release-notes/FC4 package-notes.xml,1.15,1.16 Message-ID: <200506070823.j578NgUS022933@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv22916 Modified Files: package-notes.xml Log Message: Snapshot interim of this file because of all the whitespace changes for reindenting. There is some meat in this check-in, sorry for burying it. Next commit will be purely editing. Index: package-notes.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/package-notes.xml,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- package-notes.xml 1 Jun 2005 00:02:35 -0000 1.15 +++ package-notes.xml 7 Jun 2005 08:23:40 -0000 1.16 @@ -34,8 +34,8 @@ The following sections contain information regarding packages that have undergone significant changes for &DISTRO; &DISTROVER;. For - easier access, they are organized using the same groups used in - Anaconda. + easier access, they are generally organized using the same groups + used in Anaconda.
@@ -47,193 +47,194 @@
&FEX; Repository - &FEX; is part of the larger &FP; and is a - volunteer-based community effort to create a repository of - packages that compliment &FC;. The &FEX; repository - is enabled by default from &FC; &LOCALVER; onwards. + &FEX; is part of the larger &FP; and is a volunteer-based + community effort to create a repository of packages that + compliment &FC;. The &FEX; repository is enabled by default from + &FC; &LOCALVER; onwards. - You can lean more about &FEX; from: + You can lean more about &FEX; from: - http://fedoraproject.org/wiki/Extras - - If you would like to install any software available from Fedora extras you can - use yum. + http://fedoraproject.org/wiki/Extras - yum install <packagename> + If you would like to install any software available from + Fedora extras you can use yum. + +yum install <packagename> + - Where <packagename> is the name - of the package you want to install. For example, if you wanted - to install the abiword package, the command - yum install abiword automatically installs - the package and all dependencies. + Where <packagename> is the name + of the package you want to install. For example, if you wanted + to install the abiword package, the command + yum install abiword automatically installs + the package and all dependencies.
Audit Daemon <command>auditd</command> and Log - Files - - The audit daemon, auditd, is now enabled by default. When - auditd is running, the kernel directs audit messages to - /var/log/audit/audit.log. The location of this file is - specified in /etc/auditd.conf. - + Files - AVC messages for SELinux are sent using the audit - infrastructure. These messages are now in - /var/log/audit/audit.log. + The audit daemon, auditd, is now enabled by default. When + auditd is running, the kernel directs audit messages to + /var/log/audit/audit.log. The location of this file is + specified in /etc/auditd.conf. - When auditd is not running, the kernel passes audit messages to - syslog. These logs are typically kept in /var/log/messages and - are viewable using dmesg. + AVC messages for &SEL; are sent using the audit infrastructure. + These messages are now in + /var/log/audit/audit.log. - Audit extensions are now compiled into PAM. All programs that - do grant entry to the system or change user account attributes - will generate an audit message. + When auditd is not running, the kernel passes audit messages to + syslog. These logs are typically kept in /var/log/messages and + are viewable using dmesg. - To enable auditing within the kernel, you must pass the - parameter audit=1 to the kernel during boot. Otherwise, you can - use this command to enable auditing during run time: + Audit extensions are now compiled into PAM. All programs that + do grant entry to the system or change user account attributes + will generate an audit message. - auditctl -e 1 + To enable auditing within the kernel, you must pass the + parameter audit=1 to the kernel during + boot. Otherwise, you can use this command to enable auditing + during run time: + +auditctl -e 1 +
LinuxThreads versus NPTL - As the next step in removing support for the obsolete - LinuxThreads library, code compiled and linked on &FC; - &LOCALVER; now automatically uses the NPTL headers and - libraries. - - - In previous releases since &RHL; 9, the default threading was - LinuxThreads since the interface is mostly forward compatible. - The advantages of the NPTL interface is that the cancellation - handling is faster (when -fexception is - used, even in C code) and that the additional interfaces are now - available without special compiler and linker parameters. In - other words, you do not need to use - and - any longer. Note - that lib{,64} is to be interpreted as - lib64 on platforms which place DSOs in - lib64/ directories, and - lib/ otherwise. - - - In &FC; &LOCALVER; it is still possible to create code using the - LinuxThreads definitions. For this the - linuxthreads-devel package must be - installed and - - - + As the next step in removing support for the obsolete + LinuxThreads library, code compiled and linked on &FC; + &LOCALVER; now automatically uses the NPTL headers and + libraries. + + + In previous releases since &RHL; 9, the default threading was + LinuxThreads since the interface is mostly forward compatible. + The advantages of the NPTL interface is that the cancellation + handling is faster (when -fexception is + used, even in C code) and that the additional interfaces are now + available without special compiler and linker parameters. In + other words, you do not need to use + and + any longer. Note that + lib{,64} is to be interpreted as lib64 on + platforms which place DSOs in lib64/ + directories, and lib/ otherwise. + + + In &FC; &LOCALVER; it is still possible to create code using the + LinuxThreads definitions. For this the + linuxthreads-devel package must be + installed and + + + - must be passed to the compiler. + must be passed to the compiler. - Previously, you could select the version of glibc and the - libpgthread DSH using run time environment variables. You now - need to also specify this variable in the environment: - - - LD_LIBRARY_PATH=/lib{,64}/obsolete/linuxthreads + Previously, you could select the version of glibc and the + libpgthread DSH using run time environment variables. You now + need to also specify this variable in the environment: + +LD_LIBRARY_PATH=/lib{,64}/obsolete/linuxthreads + - This additional variables is required because the run/time - libraries have been moved out of the way. There might programs - that will not work if the program uses an unfortunate DT_RPATH - (which overwrites the LD_LIBRARY_PATH setting). + This additional variable is required because the run/time + libraries have been moved out of the way. There may be programs + that will not work if the program uses an unfortunate DT_RPATH + (which overwrites the LD_LIBRARY_PATH setting). - All this makes it more cumbersome to run programs which depend - on LinuxThreads. But this is intentional. + All this makes it more cumbersome to run programs which depend + on LinuxThreads. But this is intentional. - Important - - FC5 will not have LinuxThreads support and all programs have - to be converted to use NPTL by then. - + Important + + FC5 will not have LinuxThreads support and all programs have + to be converted to use NPTL by then. + - In general, conversion to using NPTL has not been an issue. + In general, conversion to using NPTL has not been an issue.
Enabling the <filename>slocate</filename> Database - The database needed by the locate utility is no longer created - by default. Enable the database creation by setting - DAILY_UPDATE to - in /etc/updatedb.conf - if you want to use locate. + The database needed by the locate utility is + no longer created by default. Enable the database creation by + setting DAILY_UPDATE to + in /etc/updatedb.conf + if you want to use locate.
Stricter Controls in <filename>openssh</filename> - The version of OpenSSH in &FC; &LOCALVER; is based on OpenSSH - 3.9 and includes strict permission and ownership checks for the - user configuration file ~/.ssh/config. If - this file does not have appropriate ownership and permissions, - ssh will exit. + The version of OpenSSH in &FC; &LOCALVER; is based on OpenSSH + 3.9 and includes strict permission and ownership checks for the + user configuration file ~/.ssh/config. If + this file does not have appropriate ownership and permissions, + ssh will exit. - Check that ~/.ssh/config is owned by the - owner of ~/, and that its permissions are - set to mode 600. + Check that ~/.ssh/config is owned by the + owner of ~/, and that its permissions are + set to mode 600. ls -l ~/.ssh/config -rw------- 1 username username 400 May 5 18:44 /home/username/.ssh/config - The directory ~/ is command-line shorthand - for the logged in user's home directory, usually - /home/username/. - - - In addition, OpenSSH is no longer configured to request X11 - forwarding by default when connecting to servers. To enable X11 - forwarding, the or - option must be specified, or the - option must be enabled in the ~/.ssh/config - file. - - - The behavior of ssh clients that are invoked - with the option has changed. In OpenSSH 3.8 - and later, X11 forwarding is performed in a way that - applications run as untrusted clients by default. Previously, - X11 forwarding was performed so that applications always ran as - trusted clients. Some applications may not function properly - when run as untrusted clients. To forward X11 so that - applications are run as trusted clients, invoke ssh with the - option instead of the - option, or set in the - file. + The directory ~/ is command-line shorthand + for the logged in user's home directory, usually + /home/username/. + + + In addition, OpenSSH is no longer configured to request X11 + forwarding by default when connecting to servers. To enable X11 + forwarding, the or + option must be specified, or the + option must be enabled in the ~/.ssh/config + file. + + + The behavior of ssh clients that are invoked + with the option has changed. In OpenSSH 3.8 + and later, X11 forwarding is performed in a way that + applications run as untrusted clients by default. Previously, + X11 forwarding was performed so that applications always ran as + trusted clients. Some applications may not function properly + when run as untrusted clients. To forward X11 so that + applications are run as trusted clients, invoke ssh with the + option instead of the + option, or set in the + file.
Perl Binary Compat Symlinks - Binary compat symlinks for perl-5.8.0, - perl-5.8.1, and - perl-5.8.2 have been removed. If you have - perl modules built with those older versions of perl, you need - to rebuild using the perl-5.8.6 contained - in &FC; &LOCALVER;. + Binary compat symlinks for perl-5.8.0, + perl-5.8.1, and + perl-5.8.2 have been removed. If you have + perl modules built with those older versions of perl, you need + to rebuild using the perl-5.8.6 contained + in &FC; &LOCALVER;.
&SERVER-TOOLS; @@ -277,11 +278,11 @@
yum - The sqllite database is now used by yum, and makes performance - noticeably faster. + The sqllite database is now used by yum, and makes performance + noticeably faster. - The Fedora Extras repository is now enabled by default. + The Fedora Extras repository is now enabled by default.
&KERNEL; From fedora-docs-commits at redhat.com Tue Jun 7 19:23:56 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Tue, 7 Jun 2005 15:23:56 -0400 Subject: release-notes/FC4 kernel.xml,1.4,1.5 Message-ID: <200506071923.j57JNu0u006148@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv6131 Modified Files: kernel.xml Log Message: These should be the real changes to kernel.xml, and I'll do the line formating changes separately. Note the changes in how is used, dropping of , and how wraps content. IIRC, these are our style uses. Index: kernel.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/kernel.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- kernel.xml 30 May 2005 23:27:45 -0000 1.4 +++ kernel.xml 7 Jun 2005 19:23:54 -0000 1.5 @@ -25,7 +25,9 @@ You may obtain a list of any such patches by using the command on the &FC; package: - $ rpm -qpl kernel-<version>.src.rpm + +rpm -qpl kernel-<version>.src.rpm +
Kernel Flavors @@ -38,24 +40,26 @@ Native kernel, in both uniprocessor and SMP varieties. - Configured sources are available in the kernel-devel-<version>.<arch>.rpm package. + Configured sources are available in the kernel-devel-<version>.<arch>.rpm package. - Virtual kernel for use with the XEN emulator package. + Virtual kernel for use with the Xen emulator package. - Configured sources are available in the kernel-xen0-devel-<version>.<arch>.rpm package. + Configured sources are available in the kernel-xen0-devel-<version>.<arch>.rpm package. Sources for both kernel flavors may be installed at the same time. - The files will be installed into the /usr/src/kernels/<version>[-xen0]-<arch>/ tree. + The files will be installed into the /usr/src/kernels/<version>[-xen0]-<arch>/ tree. Use the command: - # rpm -Uvh kernel-devel[-xen0]-<version>.<arch>.rpm + +rpm -Uvh kernel-devel[-xen0]-<version>.<arch>.rpm + as appropriate. @@ -66,7 +70,9 @@ If you make a symbolic link, as shown below, you should be able to use those learning materials with the &FC; packages. Install the appropriate kernel sources, as shown earlier, and then: - # ln -s /usr/src/kernels/kernel-<all-the-rest> /usr/src/linux + +ln -s /usr/src/kernels/kernel-<all-the-rest> /usr/src/linux +
--- java.xml DELETED --- From fedora-docs-commits at redhat.com Tue Jun 7 19:48:32 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Tue, 7 Jun 2005 15:48:32 -0400 Subject: release-notes/FC4 RELEASE-NOTES-en.xml,1.8,1.9 Makefile,1.14,1.15 Message-ID: <200506071948.j57JmWmw006982@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv6953 Modified Files: RELEASE-NOTES-en.xml Makefile Log Message: For renaming of java -> java-package. Index: RELEASE-NOTES-en.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/RELEASE-NOTES-en.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- RELEASE-NOTES-en.xml 3 Jun 2005 03:44:05 -0000 1.8 +++ RELEASE-NOTES-en.xml 7 Jun 2005 19:48:30 -0000 1.9 @@ -25,7 +25,7 @@ - + Index: Makefile =================================================================== RCS file: /cvs/docs/release-notes/FC4/Makefile,v retrieving revision 1.14 retrieving revision 1.15 diff -u -r1.14 -r1.15 --- Makefile 2 Jun 2005 18:24:24 -0000 1.14 +++ Makefile 7 Jun 2005 19:48:30 -0000 1.15 @@ -51,7 +51,7 @@ 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.xml kernel.xml misc-server.xml multimedia.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 \ From fedora-docs-commits at redhat.com Tue Jun 7 19:50:43 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Tue, 7 Jun 2005 15:50:43 -0400 Subject: release-notes/FC4 kernel.xml,1.6,1.7 Message-ID: <200506071950.j57JohYr007378@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv7352 Modified Files: kernel.xml Log Message: Simplifying containers, matches style guidelines. Index: kernel.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/kernel.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- kernel.xml 7 Jun 2005 19:35:16 -0000 1.6 +++ kernel.xml 7 Jun 2005 19:50:41 -0000 1.7 @@ -30,7 +30,7 @@ You may obtain a list of any such patches by using the command on the &FC; package: -rpm -qpl kernel-<version>.src.rpm +rpm -qpl kernel-<version>.src.rpm
@@ -68,7 +68,7 @@ tree. Use the command: -rpm -Uvh kernel-devel[-xen0]-<version>.<arch>.rpm +rpm -Uvh kernel-devel[-xen0]-<version>.<arch>.rpm as appropriate. @@ -84,7 +84,7 @@ appropriate kernel sources, as shown earlier, and then: -ln -s /usr/src/kernels/kernel-<all-the-rest> /usr/src/linux +ln -s /usr/src/kernels/kernel-<all-the-rest> /usr/src/linux
@@ -129,7 +129,7 @@ version shown by this command: -uname -r +uname -r @@ -157,8 +157,7 @@ By running the following command: -up2date --get-source kernel +up2date --get-source kernel @@ -170,7 +169,7 @@ using the command: -rpm -Uvh kernel-<version>.src.rpm +rpm -Uvh kernel-<version>.src.rpm This writes the RPM contents into @@ -183,8 +182,8 @@ Prepare the kernel sources using the commands: -cd /usr/src/redhat/SPECS -rpmbuild -bp --target $(arch) kernel.spec +cd /usr/src/redhat/SPECS +rpmbuild -bp --target $(arch) kernel.spec The kernel source tree will be located in the @@ -196,11 +195,11 @@ generally-available documentation. -cd /usr/src/redhat/BUILD/kernel-<version> /usr/src/ -mv linux-<version> /usr/src/ -cd /usr/src -ln -s ./linux-<version> linux -cd /usr/src/linux +cd /usr/src/redhat/BUILD/kernel-<version> /usr/src/ +mv linux-<version> /usr/src/ +cd /usr/src +ln -s ./linux-<version> linux +cd /usr/src/linux @@ -214,7 +213,7 @@ file in the proper place for building: -cp configs/<desired-config-file> .config +cp configs/<desired-config-file> .config From fedora-docs-commits at redhat.com Tue Jun 7 19:55:47 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Tue, 7 Jun 2005 15:55:47 -0400 Subject: release-notes/FC4 development-tools.xml, 1.3, 1.4 hardware-reqs.xml, 1.7, 1.8 install-notes.xml, 1.9, 1.10 intro.xml, 1.6, 1.7 overview.xml, 1.5, 1.6 package-notes.xml, 1.16, 1.17 project-overview.xml, 1.3, 1.4 samba.xml, 1.6, 1.7 security.xml, 1.3, 1.4 splash.xml, 1.9, 1.10 xorg.xml, 1.5, 1.6 Message-ID: <200506071955.j57JtluU007509@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv7482 Modified Files: development-tools.xml hardware-reqs.xml install-notes.xml intro.xml overview.xml package-notes.xml project-overview.xml samba.xml security.xml splash.xml xorg.xml Log Message: This is my final Very Good Stuff read through now completed with these changes. Ain't gonna get much better than this. Index: development-tools.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/development-tools.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- development-tools.xml 31 May 2005 01:09:54 -0000 1.3 +++ development-tools.xml 7 Jun 2005 19:55:45 -0000 1.4 @@ -16,29 +16,40 @@
GCC Compiler Collection - &DISTRO; &DISTROVER; has been built using GCC 4.0, which is included with the distribution. + &DISTRO; &DISTROVER; has been built using GCC + 4.0, which is included with the distribution. Caveats - GDB 6.1 or newer is needed to debug binaries unless compiled using the -fno-var-tracking compilation option. + GDB 6.1 or newer is needed to debug binaries + unless compiled using the -fno-var-tracking compilation + option. - The -fwritable-strings option is no longer accepted. + The -fwritable-strings + option is no longer accepted. - English-language diagnostic messages now use Unicode quotes; if you cannot read this, set your LC_CTYPE environment variable to "C" or change your terminal emulator. + English-language diagnostic messages now use Unicode quotes; + if you cannot read this, set your LC_CTYPE + environment variable to "C" or + change your terminal emulator. - The specs file is no longer installed on most systems. - Ordinary users will not notice, but developers who need to alter the file can use the -dumpspecs option to generate the file for editing. + The specs file is no longer installed on + most systems. Ordinary users will not notice, but developers + who need to alter the file can use the -dumpspecs option to generate the + file for editing. @@ -46,13 +57,17 @@ Code Generation - The SSA code optimizer is now included and brings with it better constant propagation; partial redundancy elimination; load and store code motion; strength reduction; dead storage elimination; better detection of unreachable code; and tail recursion by accumulation. + The SSA code optimizer is now included and + brings with it better constant propagation, partial redundancy + elimination, load and store code motion, strength reduction, + dead storage elimination, better detection of unreachable + code, and tail recursion by accumulation. - Autovectorization is supported. - This technique achieves higher performance for repetitive loop code, in some circumstances. + Autovectorization is supported. This technique achieves higher + performance for repetitive loop code, in some circumstances. @@ -60,85 +75,107 @@ Language Extentions - A sentinel attribute has been added so that the compiler will now issue a warning if a function such as execl(char *path, const char *arg, ...), which requires a NULL list terminator is missing the NULL. + A sentinel attribute has been + added so that the compiler will now issue a warning if a + function such as execl(char *path, const char *arg, + ...), which requires a NULL + list terminator is missing the NULL. - The cast-as-lvalue, conditional-expression-as-lvalue, and compund-expression-as-lvalue extentions have been removed. + The cast-as-lvalue, + conditional-expression-as-lvalue, and + compund-expression-as-lvalue + extentions have been removed. - The #pragma pack() semantics have been brought closer to those used by other compilers. + The #pragma pack() semantics + have been brought closer to those used by other compilers. - Taking the address of a variable declared with the register modifier now generates an error instead of a warning. + Taking the address of a variable declared with the + register modifier now + generates an error instead of a warning. - Arrays of incomplete element types now generate an error. - This implies no forward reference to structure definitions. + Arrays of incomplete element types now generate an error. This + implies no forward reference to structure definitions. - The basic compiler, without any optimization (-O0), has been measured as much as 25% faster in real-world code. + The basic compiler, without any optimization (-O0), has been measured as much + as 25% faster in real-world code. - Libraries may now contain function-scope static variables in multi-threaded programs. - The -fno-threadsafe-statics can be used by embedded developers to turn off this feature, but ordinary users should never do this. + Libraries may now contain function-scope static variables in + multi-threaded programs. The -fno-threadsafe-statics can be + used by embedded developers to turn off this feature, but + ordinary users should never do this. Java - - - To avoid naming conflicts: rmic is now grmic; - rmiregistry is now grmiregistry; and - jar is now fastjar. - - - - - The GCJ compiler can now be used as a just-in-time (JIT) tool by using the gnu.jit facilities. - - - - - More support of the AWT and SWING packages have been added. - - - - - FORTRAN - - - The GNU FORTRAN 77 front end has been replaced by a new FORTRAN 90/95 recognizer. - - - - - Eclipse Development Environment - - - Eclipse 3.1M6 has been compiled as a native application. - - - - - The C Development Tool (CDT) has been included. - - - -
+ + + To avoid naming conflicts: rmic is now + grmic; rmiregistry + is now grmiregistry; and + jar is now fastjar. + + + + + The GCJ compiler can now be used as + a just-in-time (JIT) tool by using the + gnu.jit facilities. + + + + + More support of the AWT and + SWING packages have been added. + + + + + FORTRAN + + + The GNU FORTRAN 77 + front end has been replaced by a new FORTRAN + 90/95 recognizer. + + + + + Eclipse Development Environment + + + Eclipse 3.1M6 has been compiled as a native application. + + + + + The C Development Tool (CDT) has been + included. + + + + +
CPU Requirements @@ -92,7 +98,6 @@ the installed system. - In practical terms, this means that as little as an additional 90MB can be required for a minimal installation, while as much as an additional 175MB can be required for an Index: install-notes.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/install-notes.xml,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- install-notes.xml 31 May 2005 23:35:48 -0000 1.9 +++ install-notes.xml 7 Jun 2005 19:55:45 -0000 1.10 @@ -174,10 +174,10 @@ happens, restart the installation process and add the following option to the boot command line: - - pci=off - ide1=0x180,0x386 - + + +pci=off ide1=0x180,0x386 + This option allows the installation to proceed normally; any devices not detected due @@ -212,29 +212,31 @@ and the Ximian RPMs. This configuration is not supported. You have several choices in resolving this particular issue: - + - 1) You may remove Ximian - GNOME from your system prior to upgrading to &DISTRO;. + You may remove + Ximian GNOME from your system prior to upgrading to + &DISTRO;. - 2) You may upgrade your - system, and then immediately reinstall Ximian GNOME. + You may upgrade + your system, and then immediately reinstall Ximian GNOME. - 3) You may upgrade your - system, and then immediately remove all remaining Ximian - RPMs, replacing them with the corresponding &DISTRO; RPMs. + You may upgrade + your system, and then immediately remove all remaining + Ximian RPMs, replacing them with the corresponding + &DISTRO; RPMs. - You + You must resolve the version overlap using one of the above choices. Failure to do so will result in an unstable GNOME configuration. @@ -242,7 +244,7 @@
- + - This &TINY-BUG-URL; will - take you to the same pre-filled bugzilla template. + This &TINY-BUG-URL; will take + you to the same pre-filled bugzilla template. + + - + - + @@ -41,6 +41,7 @@ &FC; &FCLOCALVER; &IG; &DOCLOCALVER; + 2005 &FORMAL-RHI; @@ -93,6 +94,17 @@ + + 1.0rc1 + 2005-06-08 + KarstenWade + + + Publication edit and declaration of release candidate + + + + From fedora-docs-commits at redhat.com Thu Jun 9 00:18:19 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Wed, 8 Jun 2005 20:18:19 -0400 Subject: install-guide fedora-install-guide-firewallconfig-en.xml,1.8,1.9 Message-ID: <200506090018.j590IJEU013197@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13180 Modified Files: fedora-install-guide-firewallconfig-en.xml Log Message: Publication edit, mainly small edits made highly visible by not filling paragraphs, broken into individual commmits. Some notes about this review: this is mainly content -not- XML review, although the XML looks prit-near perfect, and I tried not to tweak the XML for the XML-sake; using 'Fedora' to discuss the 'Fedora Core' OS is a little colloquial, so I tried to catch it where I could, i.e., FED -> FC ... this is akin to 'docs' v. 'documentation'; please read and comment back directly to us author/editors -or- the mailing list. Index: fedora-install-guide-firewallconfig-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-firewallconfig-en.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- fedora-install-guide-firewallconfig-en.xml 27 May 2005 22:15:15 -0000 1.8 +++ fedora-install-guide-firewallconfig-en.xml 9 Jun 2005 00:18:16 -0000 1.9 @@ -60,7 +60,7 @@ Avoid disabling the firewall. If you believe it is necessary to - do so, however, select No firewall. + do so, select No firewall. From fedora-docs-commits at redhat.com Thu Jun 9 00:18:25 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Wed, 8 Jun 2005 20:18:25 -0400 Subject: install-guide fedora-install-guide-firstboot-en.xml,1.11,1.12 Message-ID: <200506090018.j590IPBI013220@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13203 Modified Files: fedora-install-guide-firstboot-en.xml Log Message: Publication edit, mainly small edits made highly visible by not filling paragraphs, broken into individual commmits. Some notes about this review: this is mainly content -not- XML review, although the XML looks prit-near perfect, and I tried not to tweak the XML for the XML-sake; using 'Fedora' to discuss the 'Fedora Core' OS is a little colloquial, so I tried to catch it where I could, i.e., FED -> FC ... this is akin to 'docs' v. 'documentation'; please read and comment back directly to us author/editors -or- the mailing list. Index: fedora-install-guide-firstboot-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-firstboot-en.xml,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- fedora-install-guide-firstboot-en.xml 27 May 2005 22:15:15 -0000 1.11 +++ fedora-install-guide-firstboot-en.xml 9 Jun 2005 00:18:23 -0000 1.12 @@ -5,7 +5,7 @@ The Setup Agent launches the first time - that you start a new &FED; system. Use Setup + that you start a new &FC; system. Use Setup Agent to configure the system for use before you log in. @@ -187,7 +187,7 @@ If you enable the Enable NTP Broadcast - advanced option, &FED; will attempt to automatically locate time + advanced option, &FC; will attempt to automatically locate time servers on the network. @@ -322,7 +322,7 @@ - To configure &FED; to use network services for authentication or + To configure &FC; to use network services for authentication or user information, select Use Network Login.... http://fedora.redhat.com/docs/ @@ -31,6 +31,16 @@ url="http://www.tldp.org/">http://www.tldp.org/ + + For many parts of &FC;, you may find the &RHEL; documentation + useful: + + + + http://www.redhat.com/docs/manuals/enterprise/ + + Many other organizations and individuals also provide tutorials and HOWTOs for &FED; on their Websites. You can locate @@ -70,7 +80,7 @@ The &FP; is driven by the individuals that contribute to it. Community - members provide support to other users, help to improve the + members provide support and documentation to other users, help to improve the software included in &FC; by testing, and develop new software alongside the developers employed by &RH;. The results of this work are available to all. From fedora-docs-commits at redhat.com Thu Jun 9 00:18:58 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Wed, 8 Jun 2005 20:18:58 -0400 Subject: install-guide fedora-install-guide-other-instmethods-en.xml, 1.13, 1.14 Message-ID: <200506090018.j590Iw7q013337@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13318 Modified Files: fedora-install-guide-other-instmethods-en.xml Log Message: Publication edit, mainly small edits made highly visible by not filling paragraphs, broken into individual commmits. Some notes about this review: this is mainly content -not- XML review, although the XML looks prit-near perfect, and I tried not to tweak the XML for the XML-sake; using 'Fedora' to discuss the 'Fedora Core' OS is a little colloquial, so I tried to catch it where I could, i.e., FED -> FC ... this is akin to 'docs' v. 'documentation'; please read and comment back directly to us author/editors -or- the mailing list. Index: fedora-install-guide-other-instmethods-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-other-instmethods-en.xml,v retrieving revision 1.13 retrieving revision 1.14 diff -u -r1.13 -r1.14 --- fedora-install-guide-other-instmethods-en.xml 27 May 2005 22:15:15 -0000 1.13 +++ fedora-install-guide-other-instmethods-en.xml 9 Jun 2005 00:18:55 -0000 1.14 @@ -166,7 +166,7 @@ Installation from a Hard Drive - You may install from a hard drive which contains the ISO image + You may install from a hard drive that contains the ISO image files for the &FED; discs. The hard drive may be internal to the computer or attached by USB. The partition on the hard drive holding the ISO files must be formatted with the @@ -198,7 +198,7 @@ - FAT-16, FAT-32 and <systemitem + <title>FAT-16, FAT-32, and <systemitem class="filesystem">vfat</systemitem> Before you begin installation from a hard drive, check the From fedora-docs-commits at redhat.com Thu Jun 9 00:19:04 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Wed, 8 Jun 2005 20:19:04 -0400 Subject: install-guide fedora-install-guide-packageselection-en.xml, 1.12, 1.13 Message-ID: <200506090019.j590J48n013360@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13343 Modified Files: fedora-install-guide-packageselection-en.xml Log Message: Publication edit, mainly small edits made highly visible by not filling paragraphs, broken into individual commmits. Some notes about this review: this is mainly content -not- XML review, although the XML looks prit-near perfect, and I tried not to tweak the XML for the XML-sake; using 'Fedora' to discuss the 'Fedora Core' OS is a little colloquial, so I tried to catch it where I could, i.e., FED -> FC ... this is akin to 'docs' v. 'documentation'; please read and comment back directly to us author/editors -or- the mailing list. Index: fedora-install-guide-packageselection-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-packageselection-en.xml,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- fedora-install-guide-packageselection-en.xml 29 May 2005 13:38:55 -0000 1.12 +++ fedora-install-guide-packageselection-en.xml 9 Jun 2005 00:19:01 -0000 1.13 @@ -76,7 +76,7 @@ &FC; divides included software into package groups - package groups which make + package groups that make software selection easier. @@ -107,7 +107,7 @@ To change which packages within a selected group will be installed, select the Details link next to - the name of the group. &FED; automatically installs + the name of the group. &FC; automatically installs Base Packages of a group if the group is selected. Change the selection of Optional Packages by using the checkbox next to the name of @@ -115,7 +115,7 @@ - &FED; lists with each group the number of packages currently + &FC; lists with each group the number of packages currently selected for installation, and the total number of packages within that group. @@ -144,7 +144,7 @@ Additional Language Support - Your &FED; system automatically supports the language that you + Your &FC; system automatically supports the language that you selected at the start of the installation process. To include support for additional languages, select the packages for those languages from the Language Support package @@ -175,8 +175,8 @@ - If you select Everything, &FED; installs - all of the packages provided. Although &FED; + If you select Everything, &FC; installs + all of the packages provided. Although &FC; installs many additional network services in this package group, some are not enabled after installation. This option may be useful for some testing and development purposes. @@ -201,7 +201,7 @@ After you choose the desired packages, select - Next to proceed. &FED; checks your + Next to proceed. &FC; checks your selection, and automatically adds any extra packages required to use the software you select. From fedora-docs-commits at redhat.com Thu Jun 9 00:19:10 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Wed, 8 Jun 2005 20:19:10 -0400 Subject: install-guide fedora-install-guide-rootpassword-en.xml,1.9,1.10 Message-ID: <200506090019.j590JAaP013383@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13366 Modified Files: fedora-install-guide-rootpassword-en.xml Log Message: Publication edit, mainly small edits made highly visible by not filling paragraphs, broken into individual commmits. Some notes about this review: this is mainly content -not- XML review, although the XML looks prit-near perfect, and I tried not to tweak the XML for the XML-sake; using 'Fedora' to discuss the 'Fedora Core' OS is a little colloquial, so I tried to catch it where I could, i.e., FED -> FC ... this is akin to 'docs' v. 'documentation'; please read and comment back directly to us author/editors -or- the mailing list. Index: fedora-install-guide-rootpassword-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-rootpassword-en.xml,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- fedora-install-guide-rootpassword-en.xml 27 May 2005 22:15:15 -0000 1.9 +++ fedora-install-guide-rootpassword-en.xml 9 Jun 2005 00:19:08 -0000 1.10 @@ -30,7 +30,7 @@ The &FED; installation program requires the root to be at least six characters + class="username">root password to be at least six characters long. Because the root account may potentially control any part of the system, use the following guidelines to create a good password: From fedora-docs-commits at redhat.com Thu Jun 9 15:36:25 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Thu, 9 Jun 2005 11:36:25 -0400 Subject: xml-normalize - Imported sources Message-ID: <200506091536.j59FaPD2001303@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1289 Log Message: KEEP OUT! THIS MEANS YOU! ABANDON ALL HOPE, YE WHO ENTER HERE! Playpen for debugging the XML normalization process. Status: Vendor Tag: jtr Release Tags: initial N xml-normalize/README No conflicts created by this import From fedora-docs-commits at redhat.com Thu Jun 9 15:50:32 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Thu, 9 Jun 2005 11:50:32 -0400 Subject: xml-normalize 010-text.xml,NONE,1.1 Message-ID: <200506091550.j59FoWoQ001362@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1341 Added Files: 010-text.xml Log Message: This file originally all left-justified. ***** Error reading new file: [Errno 2] No such file or directory: '010-text.xml' From fedora-docs-commits at redhat.com Thu Jun 9 15:54:33 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Thu, 9 Jun 2005 11:54:33 -0400 Subject: xml-normalize 010-text.xml,1.1,1.2 Message-ID: <200506091554.j59FsXJu001448@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1431 Modified Files: 010-text.xml Log Message: Again! From fedora-docs-commits at redhat.com Thu Jun 9 16:06:34 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Thu, 9 Jun 2005 12:06:34 -0400 Subject: sudo-tutorial sudo-tutorial-en.xml,1.1.1.1,1.2 Message-ID: <200506091606.j59G6YHw002923@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/sudo-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv2904 Modified Files: sudo-tutorial-en.xml Log Message: Checking that XML files in other directories aren't damaged during tidy-bowl testing. Index: sudo-tutorial-en.xml =================================================================== RCS file: /cvs/docs/sudo-tutorial/sudo-tutorial-en.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- sudo-tutorial-en.xml 11 May 2005 16:50:26 -0000 1.1.1.1 +++ sudo-tutorial-en.xml 9 Jun 2005 16:06:26 -0000 1.2 @@ -442,3 +442,4 @@
+ From fedora-docs-commits at redhat.com Thu Jun 9 21:04:49 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Thu, 9 Jun 2005 17:04:49 -0400 Subject: install-guide fedora-install-guide-nextsteps-en.xml,1.6,1.7 Message-ID: <200506092104.j59L4nsw011265@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv11217 Modified Files: fedora-install-guide-nextsteps-en.xml Log Message: Style edit: repetition of "develop". Index: fedora-install-guide-nextsteps-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-nextsteps-en.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- fedora-install-guide-nextsteps-en.xml 9 Jun 2005 00:18:48 -0000 1.6 +++ fedora-install-guide-nextsteps-en.xml 9 Jun 2005 21:04:39 -0000 1.7 @@ -82,7 +82,7 @@ The &FP; is driven by the individuals that contribute to it. Community members provide support and documentation to other users, help to improve the software included in &FC; by testing, and develop new software - alongside the developers employed by &RH;. The results of this + alongside the programmers employed by &RH;. The results of this work are available to all. From fedora-docs-commits at redhat.com Thu Jun 9 22:22:18 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Thu, 9 Jun 2005 18:22:18 -0400 Subject: install-guide fedora-install-guide-bootloader-en.xml,1.11,1.12 Message-ID: <200506092222.j59MMI6c012901@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12879 Modified Files: fedora-install-guide-bootloader-en.xml Log Message: - Reworded admonition to (hopefully) make it clearer that user do not have to install GRUB if a boot loader is already present. - Added titles to a couple of admonitions for consistency with the rest of the document. Index: fedora-install-guide-bootloader-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-bootloader-en.xml,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- fedora-install-guide-bootloader-en.xml 9 Jun 2005 00:17:57 -0000 1.11 +++ fedora-install-guide-bootloader-en.xml 9 Jun 2005 22:22:15 -0000 1.12 @@ -75,10 +75,11 @@ + Boot Loader Required - If you do not install any boot loader, you will not be able to - boot Linux after the installation unless you generate a startup - disk. @@ -268,6 +269,7 @@ loader options. + Kernel Parameters For a partial list of the kernel command line parameters, type the following command in a terminal window: man @@ -282,6 +284,7 @@ linkend="fig-bootloader-advanced"/> appears. + Optional Menu &FC; displays the following advanced boot options menu only if the advanced configuration checkbox From fedora-docs-commits at redhat.com Thu Jun 9 22:36:09 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Thu, 9 Jun 2005 18:36:09 -0400 Subject: install-guide fedora-install-guide-bootloader-en.xml,1.12,1.13 Message-ID: <200506092236.j59Ma9R8012978@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12961 Modified Files: fedora-install-guide-bootloader-en.xml Log Message: - Upgraded admonition to "important". - Added tags. Index: fedora-install-guide-bootloader-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-bootloader-en.xml,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- fedora-install-guide-bootloader-en.xml 9 Jun 2005 22:22:15 -0000 1.12 +++ fedora-install-guide-bootloader-en.xml 9 Jun 2005 22:36:07 -0000 1.13 @@ -74,15 +74,15 @@ - + Boot Loader Required - Your computer must have GRUB or another boot loader installed + Your computer must have GRUB or another boot loader installed in order to start, unless you create a separate startup disk to boot from. - +
From fedora-docs-commits at redhat.com Thu Jun 9 22:58:00 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Thu, 9 Jun 2005 18:58:00 -0400 Subject: install-guide fedora-install-guide-locale-en.xml,1.5,1.6 Message-ID: <200506092258.j59Mw0cD013084@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13062 Modified Files: fedora-install-guide-locale-en.xml Log Message: Removed duplicated text - language selection already determined prior to Keyboard screen. Index: fedora-install-guide-locale-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-locale-en.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- fedora-install-guide-locale-en.xml 27 May 2005 22:15:15 -0000 1.5 +++ fedora-install-guide-locale-en.xml 9 Jun 2005 22:57:57 -0000 1.6 @@ -86,10 +86,7 @@ Highlight the correct layout on the list, and select - Next. The installation process continues - in this language. This language also becomes the default language - for your system. The installation program provides additional - language support at a later stage. + Next.
From fedora-docs-commits at redhat.com Fri Jun 10 18:38:47 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Fri, 10 Jun 2005 14:38:47 -0400 Subject: install-guide fedora-install-guide-en.xml, 1.16, 1.17 fedora-install-guide-intro-en.xml, 1.10, 1.11 Message-ID: <200506101838.j5AIclJJ006749@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv6730 Modified Files: fedora-install-guide-en.xml fedora-install-guide-intro-en.xml Log Message: Rolling version to 1.0, removing draftnotice, preparing to kick this bird out of the nest. Index: fedora-install-guide-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-en.xml,v retrieving revision 1.16 retrieving revision 1.17 diff -u -r1.16 -r1.17 --- fedora-install-guide-en.xml 9 Jun 2005 00:18:10 -0000 1.16 +++ fedora-install-guide-en.xml 10 Jun 2005 18:38:43 -0000 1.17 @@ -4,16 +4,16 @@ %FEDORA-ENTITIES-EN; - + - + - + @@ -40,7 +40,7 @@ - &FC; &FCLOCALVER; &IG; &DOCLOCALVER; + &FC; &FCLOCALVER; &IG; 2005 Index: fedora-install-guide-intro-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-intro-en.xml,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- fedora-install-guide-intro-en.xml 9 Jun 2005 00:18:42 -0000 1.10 +++ fedora-install-guide-intro-en.xml 10 Jun 2005 18:38:43 -0000 1.11 @@ -2,7 +2,8 @@ Introduction - &DRAFTNOTICE; + &FC; is a complete desktop and server operating system created From fedora-docs-commits at redhat.com Fri Jun 10 19:06:43 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Fri, 10 Jun 2005 15:06:43 -0400 Subject: install-guide fedora-install-guide-en.xml,1.17,1.18 Message-ID: <200506101906.j5AJ6hsq007910@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv7891 Modified Files: fedora-install-guide-en.xml Log Message: Updating the revision history. Index: fedora-install-guide-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-en.xml,v retrieving revision 1.17 retrieving revision 1.18 diff -u -r1.17 -r1.18 --- fedora-install-guide-en.xml 10 Jun 2005 18:38:43 -0000 1.17 +++ fedora-install-guide-en.xml 10 Jun 2005 19:06:08 -0000 1.18 @@ -104,6 +104,16 @@ + + 1.0 + 2005-06-10 + KarstenWade + + + Release version + + + From fedora-docs-commits at redhat.com Sat Jun 11 17:12:23 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Sat, 11 Jun 2005 13:12:23 -0400 Subject: desktop-up2date desktop-up2date-en.xml,1.1.1.1,1.2 Message-ID: <200506111712.j5BHCNiA003955@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/desktop-up2date In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv3938 Modified Files: desktop-up2date-en.xml Log Message: Style fix - converted &em; to colons Index: desktop-up2date-en.xml =================================================================== RCS file: /cvs/docs/desktop-up2date/desktop-up2date-en.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- desktop-up2date-en.xml 5 Jun 2005 13:19:40 -0000 1.1.1.1 +++ desktop-up2date-en.xml 11 Jun 2005 17:12:20 -0000 1.2 @@ -214,15 +214,15 @@ - Blue with a check mark — Your system is up to date. + Blue with a check mark &mdash: your system is up to date. - Green with double arrows — Currently checking for updates. + Green with double arrows: currently checking for updates. - Red with a flashing exclamation mark — There are newer + Red with a flashing exclamation mark: there are newer packages available for the software installed on your system. From fedora-docs-commits at redhat.com Sun Jun 12 08:59:56 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Sun, 12 Jun 2005 04:59:56 -0400 Subject: install-guide fedora-install-guide-intro-en.xml,1.11,1.12 Message-ID: <200506120859.j5C8xuOk029275@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv29258 Modified Files: fedora-install-guide-intro-en.xml Log Message: Figured out what the problem was and fixed it. Index: fedora-install-guide-intro-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-intro-en.xml,v retrieving revision 1.11 retrieving revision 1.12 diff -u -r1.11 -r1.12 --- fedora-install-guide-intro-en.xml 10 Jun 2005 18:38:43 -0000 1.11 +++ fedora-install-guide-intro-en.xml 12 Jun 2005 08:59:53 -0000 1.12 @@ -203,10 +203,14 @@ the name of the server + + the network protocol used for installation (FTP, HTTP, or NFS) + + the path to the installation files From fedora-docs-commits at redhat.com Sun Jun 12 10:48:14 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Sun, 12 Jun 2005 06:48:14 -0400 Subject: yum-software-management yum-software-management-en.xml,1.1.1.1,1.2 Message-ID: <200506121048.j5CAmESd031822@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/yum-software-management In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv31795 Modified Files: yum-software-management-en.xml Log Message: - Added explanation of the example package to the introduction - Added using package attributes to the Search section - Reworked section on using Proxy Servers - Minor style edits - Bumped version to 0.4.2 Index: yum-software-management-en.xml =================================================================== RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- yum-software-management-en.xml 1 Jun 2005 21:31:25 -0000 1.1.1.1 +++ yum-software-management-en.xml 12 Jun 2005 10:48:11 -0000 1.2 @@ -4,7 +4,7 @@ %FEDORA-ENTITIES-EN; - + @@ -39,7 +39,7 @@ Initial import into CVS. - + @@ -79,6 +79,15 @@ updates. The details of maintaining your own repositories are explained in . + + Most of the examples use the package tsclient, + which is included with &FC; to provide an application for remote desktop + access. If it is installed successfully you may start the application + by choosing + ApplicationsInternetTerminal + Server Client. To use the examples, + substitute the name of the relevant package for tsclient. + Avoid Logging in with the Root Account @@ -95,18 +104,19 @@
Additional Resources - Yum, documentation + yum, documentation - Yum, man pages + yum, man pages The yum utility has features and options that - are not discussed in this document. You can learn more by reading the - man pages for yum(8) and yum.conf(5). + are not discussed in this document. Read the man pages + for yum(8) and yum.conf(5) to + learn more. - Yum, Websites + yum, Websites The official Website for yum is: @@ -240,8 +250,9 @@ Each package file has a long name that indicates several key pieces of - information. Yum can use just the name of the - software, or you can specify other items as well. + information. The yum utility may use just the name + of the package itself, but you may also use other attributes in the file + name to make queries more specific. For example, this is the full name of a package supplied with &FC;: @@ -255,7 +266,8 @@ tsclient-0.132. Add the hardware architecture to the short name and use tsclient.i386 to specify packages for your type of computer. The package listings provided by - yum itself use the format name.architecture. + yum itself use the format + name.architecture. Specifying Packages @@ -396,15 +408,14 @@
Updating Your System with <command>yum</command> - system updating + updating, full system - yum, updating system + yum, updating full system - Like up2date, yum can - update all of the software that makes up your &FC; system in a single - operation. This is done by the function. + You may update all of the software that makes up your &FC; system in a single + operation. This is done with the function. To carry out a full system update, type this command in a terminal window: @@ -493,6 +504,20 @@ yum list tsclient + + To make your queries more specific, add other package attributes. For example, + to search for version 0.132 of the application the command would be: + + +yum list tsclient-0.132 + + + Package Attributes + + See for information on + package attributes. + + If you do not know the name of the package, use either the or options. @@ -634,8 +659,7 @@ the package that you specified. - To install the package tsclient you should enter - the command: + To install the package tsclient, enter the command: su -c 'yum install tsclient' @@ -1106,8 +1130,8 @@ The createrepo utility makes no changes to the directory other than adding a repo-data/ - sub-directory. Other utilities may also add their own index - files to the directory. + sub-directory. Adding index files for other utilities does not + interfere with yum.
@@ -1140,49 +1164,86 @@ yum, using a proxy server - If your system is connected to the Internet through a Web proxy server, - the server must be specified in the environment variable - http_proxy. This variable must specify the proxy - server as a complete URL, including the port number. For example: + Repositories may be accessed through standard proxy servers. If your + system is connected to the Internet through a Web proxy server, specify + the details of the server in /etc/yum.conf. The + proxy setting must specify the proxy server as a + complete URL, including the TCP port number. If your proxy server + requires a username and password, specify these by adding + proxy_username and proxy_password settings. + + + + For example, the settings below enable yum to use the + proxy server mycache.mydomain.com, connecting to port + 3128, with the username yum-user and the password qwerty. - -http_proxy="http://mycache.mydomain.com:3128" - - - The URL may include a username and password, for proxy servers that - require them. If the server in the previous example required the - username yum-user and the password - qwerty the complete variable would be: - - -http_proxy="http://yum-user:qwerty at mycache.mydomain.com:3128" - + + + Configuration File Settings for Using A Proxy Server + + + + + + + Global Settings + + Defining a proxy server in /etc/yum.conf means that + all users connect to the proxy server with those + details when using yum. + + + - To enable proxy access for all users, create a new file called - proxy.sh in the directory - /etc/profile.d/, containing these two lines: + To enable proxy access for a specific user, add the lines in the + example box below to their shell profile. For the default + bash shell, the profile is the file + .bash_profile. The settings below enable yum to + use the proxy server mycache.mydomain.com, connecting to port 3128. - Profile Script for Setting the Proxy Server + Profile Settings for Using A Proxy Server - - This means that any user that logs in automatically has the environment variable set for them. - + + + If the proxy server requires a username and password then add these to the + URL. For example, to include the username + yum-user and the password qwerty: + + + Profile Settings for A Secured Proxy Server + + + + - http_proxy Variable with Other Utilities + <command>http_proxy</command> Variable with Other Utilities The http_proxy variable is also used by curl and - other utilities. Yum itself can use http_proxy in - either upper-case or lower-case, but curl requires + other utilities. Although yum itself may use http_proxy in + either upper-case or lower-case, curl requires the name of the variable to be in lower-case. +
From fedora-docs-commits at redhat.com Sun Jun 12 18:56:14 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Sun, 12 Jun 2005 14:56:14 -0400 Subject: desktop-up2date desktop-up2date-en.xml,1.2,1.3 Message-ID: <200506121856.j5CIuEkG009634@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/desktop-up2date In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv9610 Modified Files: desktop-up2date-en.xml Log Message: Fixed colons. Index: desktop-up2date-en.xml =================================================================== RCS file: /cvs/docs/desktop-up2date/desktop-up2date-en.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- desktop-up2date-en.xml 11 Jun 2005 17:12:20 -0000 1.2 +++ desktop-up2date-en.xml 12 Jun 2005 18:56:11 -0000 1.3 @@ -210,11 +210,11 @@ The icon displays the status of your system by showing one of four states: - Grey with a check mark — The first check is in progress. + Grey with a check mark: the first check is in progress. - Blue with a check mark &mdash: your system is up to date. + Blue with a check mark: your system is up to date. From fedora-docs-commits at redhat.com Sun Jun 12 21:18:20 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Sun, 12 Jun 2005 17:18:20 -0400 Subject: yum-software-management yum-software-management-en.xml,1.2,1.3 Message-ID: <200506122118.j5CLILBm013725@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/yum-software-management In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13692 Modified Files: yum-software-management-en.xml Log Message: - Split section on .repo files between "Using Software Repositories" (for installing them) and "Managing Software Repositories" (for creating and editing them) Index: yum-software-management-en.xml =================================================================== RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- yum-software-management-en.xml 12 Jun 2005 10:48:11 -0000 1.2 +++ yum-software-management-en.xml 12 Jun 2005 21:18:18 -0000 1.3 @@ -4,7 +4,7 @@ %FEDORA-ENTITIES-EN; - + @@ -589,7 +589,7 @@ yum, package management - Yum has three basic management functions: + The yum utility has three basic management functions: @@ -679,7 +679,7 @@ packages, updating - Updating a software package is essentially the same as installing a new + Updating a software package follows the same process as installing a new package. For example, to update the tsclient package to the latest version, type: @@ -720,8 +720,8 @@ -
- Finding Other Public Software Repositories +
+ Using Other Software Repositories &FEX; @@ -752,12 +752,55 @@ - You should use these sites for RPM packages of software not - included with &FC;. If these sites do not provide packages for a - specific piece of software, the manufacturer of the software may provide - or recommend a repository. + You should use these sites for software that is not included with &FC;. + If these sites do not provide packages for a specific piece of software, + the manufacturer of the software may provide or recommend a repository. +
+ Adding a Repository as a Package Source + + repositories, adding to yum + + + repository definition files, installing + + + &FC; includes a yum package that has &FED; + repositories in the configuration. To add an extra repository, place a + definition file in the /etc/yum.repos.d/ directory + on your system. Package providers make the definition files for their + repositories available on their Websites. + + + Definition File Extension + + The names of repository definition files end with .repo. + + + + Adding a file to the definitions directory requires root access. To + copy the definition file example.repo, type the command: + + +su -c 'cp example.repo /etc/yum.repos.d/' + + + Enter the root password when prompted. + + + You must also add the public key of the package provider, if you have + not not already imported it. The process is described in . + + + Repositories and <application>Up2date</application> Channels + + You should also add new package repositories as + up2date channels to ensure consistency between + the behavior of the two applications. + + +
Understanding Repository Compatibility @@ -803,150 +846,6 @@
-
- Adding Repositories as Package Sources - - repositories, adding to yum - - - The file /etc/yum.conf holds the main settings for - yum. Each repository is defined with a plain-text - file in the /etc/yum.repos.d/ directory. - - - &FC; includes a yum package that has &FED; - repositories in the configuration. These are defined to use a - mirrorlist from the master &FED; servers. - - - Each time that you run yum a server is selected from - the list, and another server will automatically be used if the selected - server fails to respond. - - - To add other repositories, place a configuration file for them in the - /etc/yum.repos.d/ directory on your system. - - - Files defining yum repositories should have the extension - .repo. They use the following format: - - - Format of <command>Yum</command> Repository Definition Files - - - - - - The baseurl must specify the complete URL for the root - directory of the repository, including the http://, - https:// or ftp:// prefix. You - can specify a directory on your system by using the prefix - file:// in the baseurl. - - - Logging in to Protected Repositories - - Yum can use password-protected directories if the - correct username and password is included in the - baseurl. For - example, ftp://user:password at myrepository.com/$releasever/mypackages/. - - - - If possible, list more than one directory or server that holds a copy of the - repository. This enables yum to use another repository if the first is - unavailable. By default yum randomly selects repositories from the - baseurl list. To force yum to use them in sequence, - add the option failovermethod=priority. - - - It is also good practice to use variables like $releasever in - the URL, rather than setting these to a specific value. The available - variables are listed on the man page for - yum.conf. Using variables enables the same - definition to function when your system is upgraded to a later version, - or if the configuration is copied to another machine. - - - An example of a definition file is shown below. In this example, copies of the - repository are held in the directory - /srv/software/&FED;/&FCVER;/mypackages/ on the - system itself, in the directory - software/&FED;/&FCVER;/mypackages/ on the Web - server www.my-repository.com/, and in the - directory pub/software/&FED;/&FCVER;/mypackages/ on - the FTP server server.another-repository.org. - Here, yum will access the FTP server with the - username yum-user and the password qwerty. - The failovermethod ensures that - yum will check the copy on the local machine, before - trying the servers in sequence. - - - Example <command>yum</command> Repository Definition File - - - - - - To use a list of servers, substitute mirrorlist for - baseurl. - - - Set gpgcheck=0 if it is necessary to disable signature - checking for the packages provided by this repository. It is not - recommended that you install unsigned packages. - - - Any .repo file that includes the setting - enable=0 is ignored by yum. - - - Repositories and <application>Up2date</application> Channels - - You should also add new package repositories as - up2date channels to ensure consistency between - the behavior of the two applications. - - - - If possible you should create your own private repository for the base operating - system packages. You can then add a definition file for your repository - and disable fedora.repo. This reduces your use of - the public repositories. See for details. - - - Older Versions of <command>yum</command> - - This tutorial documents the version of yum - included with &FC; &FCVER;. Before version 2.11 of - yum all repositories were defined in - /etc/yum.conf, rather than in separate - .repo files. Earlier versions also did not have - the ability to use a mirrorlist. - - -
- -
Maintaining <command>yum</command> @@ -966,9 +865,13 @@ repositories, removing from yum + + repository definition files, removing + Set enable=0 in a definition file to - prevent yum using that repository. + prevent yum using that repository. Any + definition file with this setting is ignored. To completely remove access to a repository: @@ -1069,7 +972,7 @@ yum. Other types of files can be held in the main directory without interfering with use of the repository. The data/ sub-directory and the XML files it - contains are created and updated with the createrepo utility. + contains are created and updated with the createrepo utility Creating Repositories Requires an Extra Package @@ -1109,22 +1012,22 @@ - The repository is now ready for use. - If you are distributing packages that you have created yourself then you - also need to make the GPG public key for your signature available, so - that others can verify the packages. The simplest way to do this is - to put the public key file on the same Website or FTP site as the repository. + Create a definition file for this new repository. If you are + distributing packages that you have created yourself then you also + need to make the GPG public key for your signature available, so that + others can verify the packages. The simplest way to make these files + available is to put the public key and repository definition files on + the same Website or FTP site as the repository. - To create a repository of all the packages supplied with &FC;, copy all of the - files from the RPMS/ directories on the - installation discs into a single directory. The - TRANS.TBL files on the discs may be discarded. - + Creating a definition file is described in . Packaging building is beyond the + scope of this document. + Repositories and Management Utilities @@ -1137,6 +1040,101 @@
+
+ Repository Definition Files + + repository definition files, creating + + + repository definition files, editing + + + Create and edit repository definition files with a text editor. + Definition files are plain-text with a standard format: + + + Format of <command>yum</command> Repository Definition Files + + + + + + The baseurl must specify the complete URL for the root + directory of the repository, including the http://, + https:// or ftp:// prefix. You + may also specify a directory on your system, by using the prefix + file:// in the baseurl. + + + Logging in to Protected Repositories + + To use a password-protected repository, include the correct username and + password in the baseurl. For example, ftp://user:password at myrepository.com/$releasever/mypackages/. + + + + If possible, list more than one directory or server that holds a copy of the + repository. This enables yum to use another repository if the first is + unavailable. By default yum randomly selects repositories from the + baseurl list. To force yum to use them in sequence, + add the option failovermethod=priority. + + + It is also good practice to use variables like $releasever in + the URL, rather than setting these to a specific value. The available + variables are listed on the man page for + yum.conf. Using variables enables the same + definition to function when your system is upgraded to a later version, + or if the configuration is copied to another machine. + + + A definition file is shown below that uses all of these features. In this example, copies of the + repository are held in the directory + /srv/software/&FED;/&FCVER;/mypackages/ on the + system itself, in the directory + software/&FED;/&FCVER;/mypackages/ on the Web + server www.my-repository.com/, and in the + directory pub/software/&FED;/&FCVER;/mypackages/ on + the FTP server server.another-repository.org. + Here, yum will access the FTP server with the + username yum-user and the password qwerty. + The failovermethod ensures that + yum will check the copy on the local machine, before + trying the servers in sequence. + + + A <command>yum</command> Repository Definition File with Failover + + + + + + To use a list of servers, substitute mirrorlist for + baseurl. + + + Set gpgcheck=0 if it is necessary to disable signature + checking for the packages provided by this repository. Avoid + distributing or installing unsigned packages. + +
+
Updating a Repository @@ -1209,7 +1207,7 @@ use the proxy server mycache.mydomain.com, connecting to port 3128. - Profile Settings for Using A Proxy Server + Profile Settings for Using a Proxy Server yum-user and the password qwerty: - Profile Settings for A Secured Proxy Server + Profile Settings for a Secured Proxy Server Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13643/docs-common Log Message: Directory /cvs/docs/docs-common added to the repository From fedora-docs-commits at redhat.com Tue Jun 14 20:20:15 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 14 Jun 2005 16:20:15 -0400 Subject: docs-common README,NONE,1.1 Message-ID: <200506142020.j5EKKF46013686@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13670 Added Files: README Log Message: Information about this directory of boilerplate. --- NEW FILE README --- Behold in this directory all the overhead files needed for any FDP document. You need all the stuff in here. Cheers From fedora-docs-commits at redhat.com Tue Jun 14 20:40:39 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 14 Jun 2005 16:40:39 -0400 Subject: example-tutorial Makefile,1.6,1.7 Message-ID: <200506142040.j5EKedmV014026@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13999 Modified Files: Makefile Log Message: Change relative paths to "docs-common" component directories. Index: Makefile =================================================================== RCS file: /cvs/docs/example-tutorial/Makefile,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- Makefile 24 Feb 2004 19:14:37 -0000 1.6 +++ Makefile 14 Jun 2005 20:40:36 -0000 1.7 @@ -7,8 +7,8 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = example-tutorial-$(LANG) XMLFILE = $(DOCNAME).xml @@ -17,7 +17,7 @@ html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images @cp ../css/fedora.css $(DOCNAME) From fedora-docs-commits at redhat.com Tue Jun 14 20:53:24 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 14 Jun 2005 16:53:24 -0400 Subject: example-tutorial example-tutorial-en.xml,1.12,1.13 Message-ID: <200506142053.j5EKrOQt014129@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14112 Modified Files: example-tutorial-en.xml Log Message: Changed relative paths for the "docs-common" components. Reference the ".ent" include file. Index: example-tutorial-en.xml =================================================================== RCS file: /cvs/docs/example-tutorial/example-tutorial-en.xml,v retrieving revision 1.12 retrieving revision 1.13 diff -u -r1.12 -r1.13 --- example-tutorial-en.xml 17 May 2005 15:51:17 -0000 1.12 +++ example-tutorial-en.xml 14 Jun 2005 20:53:21 -0000 1.13 @@ -2,12 +2,12 @@ + %FEDORA-ENTITIES-EN; - + ]> From fedora-docs-commits at redhat.com Tue Jun 14 22:30:44 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Tue, 14 Jun 2005 18:30:44 -0400 Subject: desktop-up2date Makefile, 1.1.1.1, 1.2 desktop-up2date-en.xml, 1.3, 1.4 Message-ID: <200506142230.j5EMUigN016810@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/desktop-up2date In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv16791 Modified Files: Makefile desktop-up2date-en.xml Log Message: Updated to use docs-common/. Index: Makefile =================================================================== RCS file: /cvs/docs/desktop-up2date/Makefile,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- Makefile 5 Jun 2005 13:19:40 -0000 1.1.1.1 +++ Makefile 14 Jun 2005 22:30:42 -0000 1.2 @@ -7,8 +7,8 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = desktop-up2date-$(LANG) XMLFILE = $(DOCNAME).xml @@ -17,8 +17,8 @@ html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: Index: desktop-up2date-en.xml =================================================================== RCS file: /cvs/docs/desktop-up2date/desktop-up2date-en.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- desktop-up2date-en.xml 12 Jun 2005 18:56:11 -0000 1.3 +++ desktop-up2date-en.xml 14 Jun 2005 22:30:42 -0000 1.4 @@ -1,17 +1,17 @@ + %FEDORA-ENTITIES-EN; - + - + ]> From fedora-docs-commits at redhat.com Tue Jun 14 22:36:49 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Tue, 14 Jun 2005 18:36:49 -0400 Subject: install-guide Makefile, 1.7, 1.8 fedora-install-guide-en.xml, 1.18, 1.19 Message-ID: <200506142236.j5EMangi016835@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv16816 Modified Files: Makefile fedora-install-guide-en.xml Log Message: Updated to use docs-common/ Index: Makefile =================================================================== RCS file: /cvs/docs/install-guide/Makefile,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- Makefile 1 May 2005 19:10:15 -0000 1.7 +++ Makefile 14 Jun 2005 22:36:46 -0000 1.8 @@ -7,8 +7,8 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = fedora-install-guide-$(LANG) XMLFILE = $(DOCNAME).xml @@ -17,10 +17,10 @@ html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images @mkdir -p $(DOCNAME)/figs @cp figs/*.png figs/*.eps $(DOCNAME)/figs - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: Index: fedora-install-guide-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-en.xml,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- fedora-install-guide-en.xml 10 Jun 2005 19:06:08 -0000 1.18 +++ fedora-install-guide-en.xml 14 Jun 2005 22:36:46 -0000 1.19 @@ -1,20 +1,20 @@ + %FEDORA-ENTITIES-EN; - + - + From fedora-docs-commits at redhat.com Tue Jun 14 22:45:41 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Tue, 14 Jun 2005 18:45:41 -0400 Subject: yum-software-management Makefile, 1.1.1.1, 1.2 yum-software-management-en.xml, 1.3, 1.4 Message-ID: <200506142245.j5EMjfI7016862@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/yum-software-management In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv16841 Modified Files: Makefile yum-software-management-en.xml Log Message: - Updated to use docs-common/ - Split Search section into two for clarity - Moved admonition on valid package id/names to Searching by Package Name section - Minor edits and fixes Index: Makefile =================================================================== RCS file: /cvs/docs/yum-software-management/Makefile,v retrieving revision 1.1.1.1 retrieving revision 1.2 diff -u -r1.1.1.1 -r1.2 --- Makefile 1 Jun 2005 21:31:25 -0000 1.1.1.1 +++ Makefile 14 Jun 2005 22:45:38 -0000 1.2 @@ -7,8 +7,8 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = yum-software-management-$(LANG) XMLFILE = $(DOCNAME).xml @@ -17,8 +17,8 @@ html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: Index: yum-software-management-en.xml =================================================================== RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- yum-software-management-en.xml 12 Jun 2005 21:18:18 -0000 1.3 +++ yum-software-management-en.xml 14 Jun 2005 22:45:38 -0000 1.4 @@ -1,17 +1,17 @@ + %FEDORA-ENTITIES-EN; - + - + - + ]> @@ -250,40 +250,46 @@ Each package file has a long name that indicates several key pieces of - information. The yum utility may use just the name - of the package itself, but you may also use other attributes in the file - name to make queries more specific. - - - For example, this is the full name of a package supplied with &FC;: + information. For example, this is the full name of a package supplied with &FC;: tsclient-0.132-4.i386.rpm - You should use the short name tsclient in most - cases. To specify the exact version of the application, use - tsclient-0.132. Add the hardware architecture to - the short name and use tsclient.i386 to specify - packages for your type of computer. The package listings provided by - yum itself use the format - name.architecture. + Use just the name of the package itself with yum, except when it is + necessary to specify the exact version or type. To specify the exact + version of the application, use name-version. + The package listings provided by yum itself use the format + name.architecture, to specify the type of computer + that the package is intended for. - - Specifying Packages - - You may use any of the following formats for - specifying a package in a yum query: name, - name.architecture, name-version, name-version-release, - name-version-release.architecture, and epoch:name-version-release.architecture. - - + + These are valid for the file shown above: + + + + + Package name: tsclient + + + + + Package name with version number: tsclient-0.132 + + + - The hardware architecture included in each package name is the - minimum type of machine required for that specific package. Packages - with run on any current Intel-compatible computer. Packages - for PowerPC machines, such as Apple Macs, are indicated with . - Packages with have no architecture requirement. + Package name with hardware architecture: tsclient.i386 + + + + + The hardware architecture is the minimum type of + machine required for that specific package. Packages with + run on any current Intel-compatible computer. + Packages for PowerPC machines, such as Apple Macs, are indicated with + . Packages with have no + architecture requirement. Some software can be optimized for particular types of Intel-compatible @@ -292,9 +298,15 @@ and . A computer with at least an Intel Pentium, VIA C3 or compatible chip is an . Computers with an Intel Pentium II and above, or a current - model of AMD chip, are machines. 64-bit PCs can - use packages for full 64-bit support. + model of AMD chip, are machines. 64-bit PCs use packages for full 64-bit support. + + Other Naming Conventions are Supported + + Refer to for + more information on specifying packages by name or type. + +
@@ -475,7 +487,7 @@
- Searching for Software Packages with <command>yum</command> + Searching for Software with <command>yum</command> packages, locating @@ -496,11 +508,14 @@ PalmPilot packages. - + +
+ Searching by Package Name and Attributes + To search for a specific package by name, use the function. For example, to search for the package tsclient the command would be: - + yum list tsclient @@ -511,13 +526,22 @@ yum list tsclient-0.132 - + Package Attributes - See for information on - package attributes. + You may use any of the following formats for + specifying a package in a yum query: name, + name.architecture, name-version, name-version-release, + name-version-release.architecture, and + epoch:name-version-release.architecture. - + +
+ + +
+ Advanced Searches + If you do not know the name of the package, use either the or options. @@ -559,6 +583,7 @@ +
Understanding Matches From fedora-docs-commits at redhat.com Fri Jun 17 14:38:37 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Fri, 17 Jun 2005 10:38:37 -0400 Subject: release-notes/FC4 Makefile,1.15,1.16 RELEASE-NOTES-en.xml,1.9,1.10 Message-ID: <200506171438.j5HEcbcX003342@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv3323 Modified Files: Makefile RELEASE-NOTES-en.xml Log Message: Fixed entities and Makefile definitions to use docs-common folder Index: Makefile =================================================================== RCS file: /cvs/docs/release-notes/FC4/Makefile,v retrieving revision 1.15 retrieving revision 1.16 diff -u -r1.15 -r1.16 --- Makefile 7 Jun 2005 19:48:30 -0000 1.15 +++ Makefile 17 Jun 2005 14:38:34 -0000 1.16 @@ -1,5 +1,5 @@ LANG = en -DOCS_SETUP_PATH= ../.. +DOCS_SETUP_PATH= ../../docs-common XSLPDF = $(DOCS_SETUP_PATH)/xsl/main-pdf.xsl XSLHTML = $(DOCS_SETUP_PATH)/xsl/main-html-nochunks-relnotes.xsl @@ -68,7 +68,7 @@ distclean clobber: clean ${RM} ChangeLog-${LANG}.html ChangeLog.txt - ${RM} -r README-${LANG}.pdf README-${LANG}.html README-${LANG} + ${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 Index: RELEASE-NOTES-en.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/RELEASE-NOTES-en.xml,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- RELEASE-NOTES-en.xml 7 Jun 2005 19:48:30 -0000 1.9 +++ RELEASE-NOTES-en.xml 17 Jun 2005 14:38:34 -0000 1.10 @@ -31,9 +31,9 @@ - + %FEDORA-ENTITIES-EN; - + From fedora-docs-commits at redhat.com Fri Jun 17 14:40:06 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Fri, 17 Jun 2005 10:40:06 -0400 Subject: release-notes/FC4 xorg.xml,1.6,1.7 Message-ID: <200506171440.j5HEe6bR003374@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv3357 Modified Files: xorg.xml Log Message: Fix bug #160270 Index: xorg.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/xorg.xml,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- xorg.xml 7 Jun 2005 19:55:45 -0000 1.6 +++ xorg.xml 17 Jun 2005 14:40:03 -0000 1.7 @@ -85,7 +85,7 @@ the core X font subsystem. At the present time, applications using the Qt 3 or GTK 2 toolkits (which would include KDE and GNOME applications) use the fontconfig and Xft font subsystem; - most everything else uses the core X fonts. + almost everything else uses the core X fonts. In the future, &FC; may support only fontconfig/Xft in From fedora-docs-commits at redhat.com Sat Jun 18 13:47:20 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Sat, 18 Jun 2005 09:47:20 -0400 Subject: usb-hotplug Makefile,1.1,1.2 usb-hotplug-tutorial-en.xml,1.3,1.4 Message-ID: <200506181347.j5IDlK8i001952@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/usb-hotplug In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1933 Modified Files: Makefile usb-hotplug-tutorial-en.xml Log Message: Updated old usb-hotplug tutorial with docs-common compliance Index: Makefile =================================================================== RCS file: /cvs/docs/usb-hotplug/Makefile,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- Makefile 14 Oct 2004 14:36:13 -0000 1.1 +++ Makefile 18 Jun 2005 13:47:18 -0000 1.2 @@ -7,8 +7,8 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = usb-hotplug-tutorial-$(LANG) XMLFILE = $(DOCNAME).xml @@ -17,14 +17,14 @@ html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) html-nochunks: @xmlto html-nochunks -x $(XSLHTML) $(XMLFILE) @mkdir -p stylesheet-images - @cp ../stylesheet-images/*.png stylesheet-images - @cp ../css/fedora.css . + @cp ../docs-common/stylesheet-images/*.png stylesheet-images + @cp ../docs-common/css/fedora.css . pdf: @xmlto pdf -x $(XSLPDF) $(XMLFILE) Index: usb-hotplug-tutorial-en.xml =================================================================== RCS file: /cvs/docs/usb-hotplug/usb-hotplug-tutorial-en.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- usb-hotplug-tutorial-en.xml 15 Oct 2004 20:18:59 -0000 1.3 +++ usb-hotplug-tutorial-en.xml 18 Jun 2005 13:47:18 -0000 1.4 @@ -2,7 +2,7 @@ + %FEDORA-ENTITIES-EN; From fedora-docs-commits at redhat.com Sat Jun 18 13:51:04 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Sat, 18 Jun 2005 09:51:04 -0400 Subject: mirror-tutorial Makefile,1.1,1.2 mirror-tutorial-en.xml,1.3,1.4 Message-ID: <200506181351.j5IDp41s002003@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/mirror-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv1983 Modified Files: Makefile mirror-tutorial-en.xml Log Message: Updated mirror-tutorial with docs-common compliance Index: Makefile =================================================================== RCS file: /cvs/docs/mirror-tutorial/Makefile,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- Makefile 5 May 2005 19:04:44 -0000 1.1 +++ Makefile 18 Jun 2005 13:51:02 -0000 1.2 @@ -7,8 +7,8 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = mirror-tutorial-$(LANG) XMLFILE = $(DOCNAME).xml @@ -17,8 +17,8 @@ html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf-%: Index: mirror-tutorial-en.xml =================================================================== RCS file: /cvs/docs/mirror-tutorial/mirror-tutorial-en.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- mirror-tutorial-en.xml 2 Jun 2005 12:58:17 -0000 1.3 +++ mirror-tutorial-en.xml 18 Jun 2005 13:51:02 -0000 1.4 @@ -2,7 +2,7 @@ + %FEDORA-ENTITIES-EN; From fedora-docs-commits at redhat.com Sat Jun 18 13:55:45 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Sat, 18 Jun 2005 09:55:45 -0400 Subject: release-notes/FC4 xorg.xml,1.7,1.8 Message-ID: <200506181355.j5IDtj3W002046@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv2028 Modified Files: xorg.xml Log Message: Fix bug #160271 Index: xorg.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/xorg.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- xorg.xml 17 Jun 2005 14:40:03 -0000 1.7 +++ xorg.xml 18 Jun 2005 13:55:42 -0000 1.8 @@ -100,10 +100,9 @@ - If you wish to add new fonts to your &DISTRO; &DISTROVER; - system, you must be aware that the steps necessary depend on which - font subsystem is to use the new fonts. For the core X font - subsystem, you must: + The steps to add new fonts to &DISTRO; &DISTROVER; depend on the + fonts subsystem which will use the new fonts." For the core X + font subsystem: From fedora-docs-commits at redhat.com Sat Jun 18 14:29:51 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Sat, 18 Jun 2005 10:29:51 -0400 Subject: release-notes/FC4 kernel.xml,1.7,1.8 Message-ID: <200506181429.j5IETpnV003334@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv3317 Modified Files: kernel.xml Log Message: Fix bug #160369 Index: kernel.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/kernel.xml,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- kernel.xml 7 Jun 2005 19:50:41 -0000 1.7 +++ kernel.xml 18 Jun 2005 14:29:49 -0000 1.8 @@ -183,7 +183,7 @@ cd /usr/src/redhat/SPECS -rpmbuild -bp --target $(arch) kernel.spec +rpmbuild -bp --target $(arch) kernel-2.6.spec The kernel source tree will be located in the From fedora-docs-commits at redhat.com Tue Jun 21 23:54:26 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 21 Jun 2005 19:54:26 -0400 Subject: xml-normalize 010-text.xml,1.2,1.3 Message-ID: <200506212354.j5LNsQJT018603@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18586 Modified Files: 010-text.xml Log Message: Remove stray punctuation to stay in spec Index: 010-text.xml =================================================================== RCS file: /cvs/docs/xml-normalize/010-text.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- 010-text.xml 9 Jun 2005 15:54:30 -0000 1.2 +++ 010-text.xml 21 Jun 2005 23:54:24 -0000 1.3 @@ -26,7 +26,7 @@ Reynolds
P O Box 62 -Danville, +Danville Alabama 35619
From fedora-docs-commits at redhat.com Wed Jun 22 00:07:35 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 21 Jun 2005 20:07:35 -0400 Subject: yum-software-management yum-software-management-en.xml,1.4,1.5 Message-ID: <200506220007.j5M07ZUw019717@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/yum-software-management In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19700 Modified Files: yum-software-management-en.xml Log Message: Use XMLism for empty tags, not SGML Index: yum-software-management-en.xml =================================================================== RCS file: /cvs/docs/yum-software-management/yum-software-management-en.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- yum-software-management-en.xml 14 Jun 2005 22:45:38 -0000 1.4 +++ yum-software-management-en.xml 22 Jun 2005 00:07:32 -0000 1.5 @@ -67,17 +67,17 @@ If you are a new user, read the before using + linkend="sn-software-management-concepts"/> before using yum for the first time. - Experienced Linux users should start with . + Experienced Linux users should start with . Anyone with several &FED; systems on a network may benefit from setting up their own software repositories to manage the process of installation and updates. The details of maintaining your own repositories are explained - in . + in . Most of the examples use the package tsclient, @@ -303,7 +303,7 @@ Other Naming Conventions are Supported - Refer to for + Refer to for more information on specifying packages by name or type. @@ -643,7 +643,7 @@ Search Criteria - See for details of search + See for details of search criteria. The management options of yum are case-sensitive. @@ -664,7 +664,7 @@ one sub-directory per repository. You may copy these cached packages and use them elsewhere if you wish. Removing a package from your system does not delete the downloaded RPM from the cache. See for details on purging the caches. + linkend="sn-yum-clearance"/> for details on purging the caches. @@ -815,7 +815,7 @@ You must also add the public key of the package provider, if you have - not not already imported it. The process is described in . + not not already imported it. The process is described in . Repositories and <application>Up2date</application> Channels @@ -1050,7 +1050,7 @@ Creating a definition file is described in . Packaging building is beyond the + linkend="sn-writing-repodefs"/>. Packaging building is beyond the scope of this document. From fedora-docs-commits at redhat.com Wed Jun 22 18:43:09 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Wed, 22 Jun 2005 14:43:09 -0400 Subject: release-notes/FC4 kernel.xml,1.8,1.9 Message-ID: <200506221843.j5MIh9bk011331@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv11314 Modified Files: kernel.xml Log Message: Typso fox. Index: kernel.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/kernel.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- kernel.xml 18 Jun 2005 14:29:49 -0000 1.8 +++ kernel.xml 22 Jun 2005 18:43:07 -0000 1.9 @@ -23,7 +23,7 @@ features. For this reason, the &FC; kernel may not be line-for-line equivalent to the so-called vanilla kernel from the kernel.org + url="http://www.kernel.org">kernel.org web site. From fedora-docs-commits at redhat.com Wed Jun 22 19:31:39 2005 From: fedora-docs-commits at redhat.com (Karsten Wade (kwade)) Date: Wed, 22 Jun 2005 15:31:39 -0400 Subject: release-notes/FC4 xorg.xml,1.8,1.9 Message-ID: <200506221931.j5MJVdZt012622@cvs-int.fedora.redhat.com> Author: kwade Update of /cvs/docs/release-notes/FC4 In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12605 Modified Files: xorg.xml Log Message: Typo fix and semantic twist, making the language more active. Index: xorg.xml =================================================================== RCS file: /cvs/docs/release-notes/FC4/xorg.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- xorg.xml 18 Jun 2005 13:55:42 -0000 1.8 +++ xorg.xml 22 Jun 2005 19:31:36 -0000 1.9 @@ -101,7 +101,7 @@ The steps to add new fonts to &DISTRO; &DISTROVER; depend on the - fonts subsystem which will use the new fonts." For the core X + fonts subsystem this is going to use the new fonts. For the core X font subsystem: From fedora-docs-commits at redhat.com Thu Jun 23 22:21:23 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Thu, 23 Jun 2005 18:21:23 -0400 Subject: docs-common/common README,1.1,1.2 Message-ID: <200506232221.j5NMLNFJ015835@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/docs-common/common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv15818/docs-common/common Modified Files: README Log Message: Tweak to fall in line with accepted practice and new DocGuide Index: README =================================================================== RCS file: /cvs/docs/docs-common/common/README,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- README 3 Jun 2005 04:05:38 -0000 1.1 +++ README 23 Jun 2005 22:21:18 -0000 1.2 @@ -11,10 +11,11 @@ draftnotice-en.xml Used when a document is in draft/beta stage. This is usually put at - the very top of the parent XML file so that it is the first thing - read. Calls to this entity are removed when the document is moved - to a live status. This prevents confusion in thinking a beta - document is the genuine document. + the very top of the parent XML file, or in the introduction of a + tutorial, so that it is the first thing read. Calls to this entity + are removed when the document is moved to a live status. This + prevents confusion in thinking a beta document is the genuine + document. fedora-entities-en.ent From fedora-docs-commits at redhat.com Fri Jun 24 20:29:57 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Fri, 24 Jun 2005 16:29:57 -0400 Subject: usb-hotplug usb-hotplug-tutorial-en.xml,1.4,1.5 Message-ID: <200506242029.j5OKTvp9014156@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/usb-hotplug In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14139 Modified Files: usb-hotplug-tutorial-en.xml Log Message: Entity changes, tag cleanup, legacy notice added Index: usb-hotplug-tutorial-en.xml =================================================================== RCS file: /cvs/docs/usb-hotplug/usb-hotplug-tutorial-en.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- usb-hotplug-tutorial-en.xml 18 Jun 2005 13:47:18 -0000 1.4 +++ usb-hotplug-tutorial-en.xml 24 Jun 2005 20:29:54 -0000 1.5 @@ -5,14 +5,14 @@ %FEDORA-ENTITIES-EN; - - + + + ]>
<command>usb-hotplug</command> Tutorial - &FC; 1 and 2 2003, 2004 @@ -50,19 +50,27 @@ Style and syntax edits by Wade, finished by Frields, edits by tfox before publication. + + 0.53 + Jun 24 2005 + PaulWFrields + Added legacy notice, changed entities, and fixed + section tags + - +
Introduction + &LEGACYNOTICE; Important - This document is intended for users of &FC; &LOCAL-FCVER; (or previous + This document is intended for users of &FC; &FCLOCALVER; (or previous versions) only. Newer versions of &FC; have new facilities for adding hot-pluggable storage devices. - +
Overview &FC; uses the hotplug facility to recognize when new @@ -82,8 +90,8 @@ configure these components improves the effectiveness of existing tools, such as the usermount helper. - - +
+
About This Document The most up-to-date version of this document is always found at the &FP; @@ -97,16 +105,12 @@ this document: &BOOKID; - Comments and suggestions may also be forwarded to the author at stickstr5 at hotmail.com. - - Portions of this document were suggested by tips written by Tim Waugh and available at the time of writing at http://cyberelk.net/tim/usb-storage.html. - - +
+
Acknowledgments The author is grateful to Dave Pawson for his help in finding gaps in @@ -115,9 +119,9 @@ support, and kept this document concise and readable, and its style consistent. - - - +
+
+
Summary @@ -221,8 +225,8 @@ - - +
+
The <command>hotplug</command> Configuration Files The file /etc/hotplug/usb.distmap contains a list of @@ -298,7 +302,7 @@ determine whether the USB mass storage driver module was loaded. If the usb-storage module is listed, do not edit your hotplug - configuration files. Skip to and + configuration files. Skip to and follow those steps to continue diagnosing the problem. @@ -381,16 +385,16 @@ --> - - +
+
The <command>updfstab</command> Configuration Files If hotplug automatically loaded the proper module for - you (refer to ), check + you (refer to ), check /etc/fstab for an entry for your device. If your device has an entry, you should now see it in your graphical browser. If you still can't mount the device, the console owner may not own the device - file. Skip to to continue troubleshooting. + file. Skip to to continue troubleshooting. To see if your system now has enough information to properly update @@ -404,7 +408,7 @@ updfstab files. - +
<filename>/etc/updfstab.conf</filename> The main configuration file is /etc/updfstab.conf. @@ -422,8 +426,8 @@ include /etc/updfstab.conf.default - - +
+
<filename>/etc/updfstab.conf.default</filename> @@ -485,8 +489,8 @@ information, as well as a complete directive reference. Issue the command man updfstab to read it. - - +
+
Adding Devices To add a device to the updfstab facility, create the @@ -633,9 +637,9 @@ --> - - - +
+
+
PAM PAM, or Pluggable Authentication Modules, is a @@ -646,7 +650,7 @@ system documentation, at /usr/share/doc/pam-version/txts/pam.txt. - +
<filename>/etc/security/console.perms</filename> This tutorial discusses only a small subset of the PAM system, the @@ -682,13 +686,13 @@ properly inherit changes. - - +
+
Adding Device Access Permissions Create a new device class that points to the mount point you assigned in your /etc/updfstab.conf.custom file in . Name the class after your + linkend="sn-adding-devices"/>. Name the class after your device directive for simplicity. Also create a permission definition which describes what permissions the console user inherits after logging in, and how these permissions revert @@ -722,9 +726,9 @@ updfstab.conf.default. - - - +
+
+
Running <command>updfstab</command> Now run the updfstab command to properly update the @@ -785,8 +789,8 @@ Computer on your desktop) displays your removable device as well. - - +
+
References @@ -806,5 +810,5 @@ - +
From fedora-docs-commits at redhat.com Fri Jun 24 20:39:42 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Fri, 24 Jun 2005 16:39:42 -0400 Subject: proxy-guide proxy-guide-en.xml, NONE, 1.2 Makefile, NONE, 1.2 proxy.eps, NONE, 1.2 proxy.png, NONE, 1.2 fedora-proxy-guide-en.xml, 1.1, NONE Message-ID: <200506242039.j5OKdgU4014225@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/proxy-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14206 Modified Files: Tag: 1.2 Makefile proxy.eps proxy.png Added Files: Tag: 1.2 proxy-guide-en.xml Removed Files: fedora-proxy-guide-en.xml Log Message: Renamed file to eliminate redundancy and other possible script headaches --- NEW FILE proxy-guide-en.xml --- %FEDORA-ENTITIES-EN; ]>
&PROJECT-TITLE; Henry Gavin 2004, 2005 &FORMAL-STL; Gavin Henry Fedora-docs Project Thanks for the DocBook XML documentation guide 2005-02-06 0.3 2005-02-06 GH Updated for release to the Fedora Documentation Project, now using &FC; 3 instead of Red Hat Linux 9 0.2 2004-02-27 GH Spelling mistake corrections. Thanks to Charles Curley. 0.1 2003-11-08 GH Article's initial release for general review. &LEGALNOTICE; The goal of any Network Engineer or System Administrator is to provide maximum security with maximum functionality. It's no use allowing everyone full internet access without monitoring and content filtering in place, which could possibly breach your IT policy. This is where a secure proxy server comes in.
Introduction A proxy server is a must when monitoring, content filtering and security are required, as it allows only one point of entry/exit for internet access. This is where Squid comes in. Squid is a very versatile and configurable proxy server with numerous features, not to mention password authentication and plugin capabilities. This guide will take any level of user through the necessary steps in setting up a proxy server (squid) with password authentication and content filtering (with a plugin package called squidGuard) and logfile monitoring with email notification, which is handled with a program called swatch. Extra chapters are included covering: Improvements Troubleshooting
Packages required The &PROJECT; requires the following packages: Squid, latest rpm available from — RedHat's rawhide repository SquidGuard, available here blacklists for SquidGuard, available here Swatch, available here Squid and iptables should come with any good distribution, so check your distro CD's first before going on the net. The rest you will need to download.
Squid installation and configuration Check if Squid is installed and if not, install by performing the following: Check to see if it is installed by typing rpm -q squid, this should output something like: squid-2.5.STABLE3-0 If not, download the latest rpm from the website shown in su - then type your root password and then rpm -ivh *.rpm in the directory that squid is in.
squid.conf The four files to check for, which are the most important for us are: /etc/squid/squid.conf — main configuration file /var/log/access.log — for monitoring url activity /var/log/cache.log — for checking that squid is caching /usr/lib/squid/ncsa_auth — for password authentication The ncsa_auth authentication program does not do md5 encryption by default, it uses CRYPT encryption. There are two other ways of supporting md5 encryption that I am aware of, but as we are quite happy without it, we will not use either. You can apply a patch that was written by Martin Houston of Smoothwall here in May 2003 for ncsa_auth Or download another authentication program called squidauth squid.conf is pretty heavily commented so most options are pretty obvious. I will show the main ones changed or added in here. The squid.conf shown below does not have the squidGuard option added in yet. It will be added in the section. Changes in squid.conf #Changed by GH 24/09/03 - Default is off: emulate_httpd_log on # Added by GH 24/09/03 for user authentication auth_param basic program /usr/lib/squid/ncsa_auth /etc/squid/passwd auth_param basic children 5 auth_param basic realm Suretec Proxy Server - ALL ACCESS IS STRICTLY MONITORED auth_param basic credentialsttl 2 hours # Uncommented by GH 24/09/03 for password authentication and blocking exe zip gz bz2 mp3 mpg mpeg ram rpm avi plus more acl password proxy_auth REQUIRED acl download urlpath_regex -i "/etc/squid/denydownload.txt" acl POST method POST # GH 24/09/03 acl suretecsystems.private src 192.168.210.0 acl suretecsystems.test src 192.168.100.0 acl Safe_ports port 80 # INSERT YOUR OWN RULE(S) HERE TO ALLOW ACCESS FROM YOUR CLIENTS # Example rule allowing access from your local networks. Adapt # to list your (internal) IP networks from where browsing should # be allowed # acl our_networks src 192.168.1.0/24 192.168.2.0/24 # http_access allow our_networks # Used to block downloads and allow other users - GH 07/01/03 http_access deny download !POST http_access allow suretecsystems.private http_access allow suretecsystems.test password # And finally deny all other access to this proxy http_access allow localhost http_access deny all visible_hostname suretecsystemsproxy You will notice the acl download urlpath_regex -i "/etc/squid/denydownload.txt" line which points squid to a text file with file extensions we wish to block. The ownership of this file needs to be set to squid using the usual command: chown squid:squid /etc/squid/denydownload.txt and the general syntax required is: \.exe$ \.zip$ \.gz$ \.bz2$ \.mp3$ \.avi$ \.mpg$ \.mpeg$ \.ram$ \.rpm$ Remember, if you do not add the word password to the end of your http_access line, then password authentication will not be called by squid.
Password file Next, we need to create the passwd file. We do this by using the htpasswd command (part of the apache httpd package). Navigate to /etc/squid and type mkdir etc/ then htpasswd -d -c passwd username The output will be: [root at suretecsystemsproxy squid]# htpasswd -d -c passwd username New password: Re-type new password: Adding password for user username now, change the file permissions so squid can read it, As root type: chown -R squid:squid /etc/squid/etc/passwd chmod 600 /etc/squid/etc/passwd Issue the command squid -k reconfigure and test. Test by changing the appropriate settings in your favourite browser. You can debug squid to check everything is working by issuing squid -X. If you are unsure of any options when using any command line tool, always add --help onto the end of it. You should be presented with the following prompt:
User & password popup User prompt using Internet Explorer
Installing and configuring SquidGuard SquidGuard can be used to: Limit the web access for some users to a list of accepted/well known web servers and/or URLs only. Block access to some listed or blacklisted web servers and/or URLs for specific users. Block access to URLs matching a list of regular expressions or words for specific users. Enforce the use of domain names/prohibit the use of IP address in URLs. Redirect blocked URLs to an "intelligent" CGI based info page. Redirect an unregistered user to a registration form. Redirect popular downloads like Netscape, MSIE etc. to local copies. Redirect banners to an empty GIF. Have different access rules based on time of day, day of the week, date etc. Have different rules for different user groups. and much more..... Neither squidGuard nor Squid can be used to: Filter/censor/edit text inside documents Filter/censor/edit embedded scripting languages like JavaScript or VBscript inside HTML.
Installation The first we need to have is the actual package. Download from the url given in Now navigate to where you saved the file and issue the commands: tar -xzvf squidGuard-1.2.0.tar.gz ./configure --with-sg-config=/etc --with-sg-logdir=/var/log --with-sg-dbhome=/usr/local/squidGuard/db make make test make install
SquidGuard Configuration We now need to create a /etc/squidGuard.conf. Using pico as our editor, issue the command pico -w /etc/squidGuard.conf then make it look something like the example below: Creating a /etc/squidGuard.conf file # Gavin Henry 26/09/03 # initial conf file for squidGuard logdir /var/log/ dbhome /usr/local/squidGuard/db dest ads { domainlist ads/domains urllist ads/urls } dest aggressive { domainlist aggressive/domains urllist aggressive/urls } dest audio-video { domainlist audio-video/domains urllist audio-video/urls } dest drugs { domainlist drugs/domains urllist drugs/urls } dest gambling { domainlist gambling/domains urllist gambling/urls } dest hacking { domainlist hacking/domains urllist hacking/urls } dest mail { domainlist mail/domains } dest porn { domainlist porn/domains urllist porn/urls } dest proxy { domainlist proxy/domains urllist proxy/urls } dest violence { domainlist violence/domains urllist violence/urls } dest warez { domainlist warez/domains urllist warez/urls } acl { default { pass !ads !aggressive !audio-video !drugs !gambling !hacking !mail !porn !proxy !violence !warez all redirect http://www.suretecsystems.com/redirect/index.html } } Now that the url lists have been defined, it's time to install them. Navigate to the home directory of squidGuard, which is indicated in the squidGuard.conf. In /var/local/squidGuard/db extract the blacklists.tar.gz that you downloaded from here . These are updated daily and we will be configuring an update script in . tar -xzvf blacklists.tar.gz mv blacklists/* ../db squidGuard -C all If you get an error saying command not found then the path to squidGuard is not in your ~/.bash_profile Using pico open up ~/.bash_profile and add /usr/local/squidGuard/bin to the PATH: section. We now need to test that things are blocked, passed and redirected. We are going to put example urls in a few files. Create the files in any directory and test squidGuard with these commands: echo "http://www.cnn.com 10.0.0.1/- - GET" > test.pass echo "http://www.playboy.com 10.0.0.1/- -GET" > test.block squidGuard -c /etc/squidGuard.conf < test.pass > test.pass.out squidGuard -c /etc/squidGuard.conf < test.block > test.block.out wc -l test.pass wc -l test.pass.out wc -w test.pass.out wc -l test.block wc -l test.block.out diff test.block test.block.out | egrep -ic '^> ..* [0-9.]+/..* ..* [a-z]+$' more test.block.out The first set of commands create the test files with urls that resemble what would appear in /var/log/squid/access.log. The second set of commands test squidguard and the last set check that the results are as expected. wc -l test.pass etc. should have identical numerical results for the first 2 commands and 0 for the last. wc -l test.block etc. should have identical results for the first 3 tests. The more lets you visually check that the blocked url is redirected as expected. Copy the suretecsystemslogo.gif (save it from the suretecsystems website) into /var/www/html directory and create a webpage that is shown when a banned url is reached using the following code (copy and paste this into a file called index.html in /var/www/html: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <title>THIS WEBSITE IS BANNED</title> </head> <body> <table> <tr> <td<>img src="http://www.suretecsystems.com/suretecsystemslogo.gif" width="137" height="81" border="0" name="suretecsystems" alt="Suretecsystems Logo" align="right"></td> <td><b><h1>BANNED</h1></b><b>You have reached this page because you are trying to view a banned website. If you feel that this site has been wrongly banned then contact our administrator at <a href="mailto:scott.forbes at suretecsystems.com?Subject=Banned Website&Body=This should not be banned"> Suretecsystems Proxy Help</a></b></td> </tr> </table> </body> </html> Open up your favourite editor and uncomment the line in /etc/squid.conf with redirect_program in it and change it to: redirect_program /usr/local/squidGuard/bin/squidGuard -c /etc/squidGuard.conf Make squid re-read it's configuration file using squid -k reconfigure Test with your browser by entering a banned url eg. http://www.playboy.com You should be redirected to your custom webpage. Setup complete.
Swatch installation and configuration Swatch is an active log file moinitoring tool. It started out as the "Simple Watchdog" for actively monitoring log files produced by UNIX's syslog facility. It has since been evolving into a utility that can monitor just about any type of log. — taken from the main swatch website.
Swatch installation Download the swatch package, as shown in . To install, simply issue the following commands: perl Makefile.PL make make test make install make realclean Swatch installs just like a CPAN module. If you are not familiar with this process then you may want to read about it by issuing the command: man ExtUtils::MakeMaker Use the perldoc command if your man cannot find the document. If you see messages like these: Warning: prerequisite Date::Calc 0 not found at (eval 1) line 219. Warning: prerequisite Date::Parse 0 not found at (eval 1) line 219. Warning: prerequisite File::Tail 0 not found at (eval 1) line 219. Warning: prerequisite Time::HiRes 1.12 not found at (eval 1) line 219. Then you need to install the CPAN module(s) that it doesn't find, before you can use swatch. You can find these modules at search.cpan.org. However, many operating systems may already provide perl rpm's so you should check with them first. You can also use the command perl -MCPAN -e shell and get an interactive installer/shell, to install the perl modules. The shell is very simple and handles all dependancies. However, with any installer, manual intervention may be required to install the latest required package.
Swatch Configuration Now that swatch is installed, it needs to be configured. We need to create a ${HOME}/.swatchrc Ours will be simple, but for more options type: man swatch Make it look like: # Swatchrc file for monitoring Squid Proxy access.log to see what people are doing. # # This will check for any url's with microsoft, suretecsystems, hotmail, msn or bearshare in the # title. It will then send and e-mail with a subject of '----PLEASE INVESTIGATE---- watchfor /NONE/ mail=scott.forbes at suretecsystems.com, subject=----PLEASE INVESTIGATE---- throttle 10:00:00 This constantly monitors the /var/log/squid/access.log logfile and checks for the word NONE (the word NONE is written to the access.log file when a banned url is visited) and then sends an email to scott.forbes at suretecsystems.com with the given subject. Start it by typing: swatch --config-file=/root/.swatchrc --tail-file=/var/log/squid/access.log & or if you want it to start at boot time, then enter the following into /etc/rc.d/rc.local swatch --config-file=/root/.swatchrc --tail-file=/var/log/squid/access.log & You can't simplier than that.
Improvements Switch proxy password encryption over from CRYPT to MD5 Add in a hardened, more secure kernel, such as grsecurity Write a firewall script to make the server more secure by allowing only certain IP addresses to login for administration purposes only and incorporate a new setting in swatch to log this. Write a script to automatically update the blacklists with the daily new releases for url monitoring. Switch ssh password login over to passphrase style login, or even better, a "One Time Password System". Uninstall all unnecessary packages, including the XFree86 server (GUI server), as unnecessary packages, mean unnecessary risk. Set up console access in case main server login becomes unaccessable and this way you can log in via the serial port. Employ a strict backup scheme for all configuration files.
Troubleshooting Remember, the man pages are your friend!! Whenever you are unsure of a commands options, always type man "command name" or command --help Always try google too, as someone, somewhere else has probably been in the same situation as you and solved the problem, or knows where to look. If all else fails, just ask Suretec Systems Ltd.
--- NEW FILE Makefile --- ############################################################################### # Makefile for RHLP docs project # Created by: Tammy Fox # Last edited by: Gavin Henry # WARNING: need passivetex 1.24 for pdf generation to work # License: GPL # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### XSLPDF = ../xsl/main-pdf.xsl XSLHTML = ../xsl/main-html.xsl LANG = en DOCNAME = fedora-proxy-guide-$(LANG) XMLFILE = $(DOCNAME).xml ###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images @cp ../css/fedora.css $(DOCNAME) pdf: @xmlto pdf -x $(XSLPDF) $(XMLFILE) ###################################################### clean: @rm -rfv *.html *.pdf *.tex $(DOCNAME) --- NEW FILE proxy.eps --- %!PS-Adobe-3.0 EPSF-3.0 %%Creator: GIMP PostScript file plugin V 1.17 by Peter Kirchgessner %%Title: proxy.eps %%CreationDate: Sun Feb 6 19:20:10 2005 %%DocumentData: Clean7Bit %%LanguageLevel: 2 %%Pages: 1 %%BoundingBox: 14 14 365 243 %%EndComments %%BeginProlog % Use own dictionary to avoid conflicts 10 dict begin %%EndProlog %%Page: 1 1 % Translate for offset 14.173228346456694 14.173228346456694 translate % Translate to begin of first scanline 0 228.21299879887897 translate 350.32697184038437 -228.21299879887897 scale % Image geometry 350 228 8 % Transformation matrix [ 350 0 0 228 0 0 ] % Strings to hold RGB-samples per scanline /rstr 350 string def /gstr 350 string def /bstr 350 string def {currentfile /ASCII85Decode filter /RunLengthDecode filter rstr readstring pop} {currentfile /ASCII85Decode filter /RunLengthDecode filter gstr readstring pop} {currentfile /ASCII85Decode filter /RunLengthDecode filter bstr readstring pop} true 3 %%BeginData: 55291 ASCII Bytes colorimage JcC<$U]5i~> JcC<$U]5i~> JcC<$U]5i~> JcC<$U]5i~> JcC<$U]5i~> JcC<$U]5i~> !rr)aJa7mQWp9beaT)9j~> !rr)aJa at sSX6]uTX3(DAJ,~> !rr)aJa7mQWp9beaT)9j~> "98)^pOW*jpoO5na&/W3s*t~> "98)]p4 "98)^pOW*jpoO5na&/W3s*t~> "TS2bjK!j$WLEmXLReUJQq=(Qs*t~> "TS2`i2H=:l'h:7p71N at oq(oMl_+$Hm%XQ&[po #64DdjL;@uk-EsP!4:anjgG/uij]!!ik"6`iOf0(k.]chi5#T4Rn9CTs*t~> "TS2bj&:L/W;lo$LBn&UNCfoFs*t~> "TS2`i)01J!!2`qoa(4!pCI<;p(RKBq%s)Np)F&Sp`T;V!%.Cf!%Rdq!&++$!&=4)!&sa6!'Bm: !'p #64Ddj-=\1kBd2XiIh2dj,i6DMJS4TLUs*t~> "TS2bj&:L/W;lo$V?d/Rp6PoI at g33]p6Q&K)@/rp8Yc=cJ,~> "TS2`i)01J!!2`qoa(4!pCI<;p(RKBq%s)Np)F&Sp`T;V!%.Cf!%Rdq!&++$!&=4)!&sa6!'Bm: !'p #64Ddj-=\1kBd2XiIh2dj, "TS2bj&:L/W;lo$V?d2np\3bQe6rIc`9[0Z#cJUH8rZE;s8RT~> "TS2`i)01J!!2`qoa(4!pCI<;p(RKBq%s)Np)F&Sp`T;V!%.Cf!%Rdq!&++$!&=4)!&sa6!'Bm: !'p7c h<=Uq#cT at gPa=t;s8RT~> #64Ddj-=\1kBd2XiIh2dj, #ljVfj&5q(cg:YU!$h@@!XC+mo)K!*coqVVhc'CP!s^+k"7Z?o!b;"$!W2p&-HGMuc0/+3h#IOA erKs/!!!/!#UDt5c+^fA-R'OAZbEG6":2p%_m,o>^:q+KXhK]-#YL(JU]:@E~> #ljVdi)'J%cg:YU!%7aG"T\`/$S3 at q"SrB.^=#CYI,S?-$j..r-4fh^!##2D"rD=T at 20IlrYPl# bjWs,l=V=9)uq)U+SR,]-Mo1p?/2,(-n>$D!&++$!&=4)!&sa6!'Bm:!'ps2X-YSa28YlCdJ,~> #ljVfj-=\Ck4S`8!0@#(!e6;gp3R*pKS8:ITSC5MX8 at PPLR+'VoRmF(N/Wb,r3#pU#G(#Okih]J O8"S5NTcT/YO9f)ig^"EihZXUk,eWhijAcskIgl1iPm7ecHb/9c+^fA-R'OAZbEG6?H_lq_m,o> ^:q+KXhK]MXN?u(U]:@E~> #ljVfj&5q)e[bDS!\3Z4o)K!0s0<\kk#M9Y""W'"'Cc&*"(qR1!W2p&-dBF,!2Sg,h#IOCglhl9 !!!/!#UDt5c+U5!3i?0qI_D^T":2p%_Mp0 at Up4YMI(bFP#YL(JU]:@E~> #ljVdi)'J&e[PAT"T\`//aoA/"SrB.`;d4lJ*1/8$j/B at VB5IC!##2D"rDF^@hf[nrYPl$dDm(@ X6N"G)uq)U+SR,]-Mo1p?fIn4-n>$D!&++$!&=4)!&sa6!'Bm:!'p #ljVfj-=\Dl.l#[!gEB)p3R*pKS8Ccfoj/AXS[YQRI&=\oRmF(N/Wb-s0)N/ZE^SbJ'C NTcT/Yjp2/ig^"EihZXUk,eWhijAcskIgl1iPm7ecHb/9c+U5!3i?0qI_D^T?H_lq_Mp0 at Up4YM I(bFpXN?u(U]:@E~> #ljVfj&5q)e[bVY'-_dbOFA]0nCC)1EKH8^$rrC7%/p54^]3,$J`]r4)?,^:-S*m%>>fl4HY,L( //3AkO?XClODJP/;0QmmrW"T!c+j;ZV!'3ZJ<5=9!$75`3(4)!= !+M"jn<4!M!!!/!#UDt5c+UQ0KS_ESU:mO#":2p%_S)-f2+8O<]tK=<#YL(JU]:@E~> #ljVdi)'J&e[PJW'-hjcOFSr8nC:,8FHM\g&6k?H'`J at D`;e_1LZ_tP-N98L1H!n=@pOd[K5XDL 3[96DQr#)MR!Ngu+u*''OZ:a%cTSn'BmM+4(KCn*ISOIqe83ffqO .!qYuntdib.etUq0DI4$1&!L)2u5K648(c:5kmVF6MX%M8,#UL9`S#d;#jPi<<-(o=TD_&?2.h. @ejR8BD6-7D#eMME<(+VFX3FGbe(3)K8;9RTXq-t4FGr>_7Gaa2+8O<]"3_GBU"iTV#UIF~> #ljVfj-=\Dl.l5a+-!nO`P.P"q!+Q#\AcFcJZ-Q#JprB+j8\PS`:C!_P5`QBQ^R4+YH5O5^U9fX R?##'aeOs0c+LXfYJ\&=rerM$ki@\]f_(f/`m)MsN1A/;ViIChd'K1RaJI7l\'CVBajA83T?,?e PebZ$q9t\iS,fAEV#[RYXT5Zd[/dc#]`>h+`[AmRcJ%p8]s`- +TM0)j&5q)eaC;k497V!s.ld*:@Pb7J)=IYdW(W6?3U<.-bo]]SVZE.+h#6NZ-,\k\MKB(Ctc77 s%f]5=-1[?\DfAXs4-"'$2soX-dD.t_WbM:'K8I_]1KWKSD$-.]UmPcW7=]BN0a3-[^&W)^KfI2 ,AZOMDrd)bUAt8sV?d5ooZdBK&rnG5X1c3G9`ta>hSQt=P;!]*rk/Sq'F7 +TM0'i)'J&eaC;k5lj.'s.um-;=M"Ea-n>$D!&++$!&=4)!&sa6!'Bm:!'p 9E4_Tj-=\Dl1a)mSU?pos3K9OVt\o'_!nG;kd8P)Y'thQK]E+4cH#LWPhkDog#f4!gmlRU\F/+_ s/OZ0Y0#k'eF0KpiRdG2g at 2HKdF.s#in^urjhC6L U;Zi at _t;EEig^"EihZXUk,eWhijAcskIgl1iPl&CcHb/9c2PBhN[dW$]tLC>?H_lq_S*UG0GK9@ ]a0NQXN?u(U]:@E~> +92'(j&5q)e[u7t!rtL48-bVYS`gep3V93;ih(^X-l at puYR,ipY. at dS&8g'p8LkrVZKk :Y*0&D_dHfOK1uO`@">@Qg/01\fq#C3fqG>k@'p.9hfs:[; r%(.hP6 at W\!!K/)!_Dt.rk/Ai/o(C!(o^44#fGN9]rOR:)()>r]o*R18rZE;s8RT~> +92'&i)'J&e[c+r"9:U>S/\*Q>jnM?qNG3k(!g)bD:s(!)brYQS8dE*RV,T\1PeCO$C:ep&H3$V#9Z:6j[rV6Elq\!Z!Y;W-7KAXEl TDVDjih\.R.etUq0DI4$1&!L)2u5K648(c:5kmVF6MX%M8,#UL9`S#d;#jPi<<-(o=TD_&?2.h. @ejR8BD6-7D#eMME<(+VFU4H+be(HtLb_7HU8'cJBq]"3_GBU"iTV#UIF~> 9)nVSj-=\Dl.poAI=%INb)+F2Y4p7heGSRolF>%+RlELr;QZm s/PDBQ+-G*hsHQ;s8T9`rJUfKkiVl,'oeh+`WaK0cJ%p8rk/Ai/o(C!(o^59bOOH+]rOR:)()>r ]o+_Kadbqts8RT~> #ljVfj&5q)e[bVY&j=s7(7j&\n"B`YjsM3H3LAGZr;\4[c6m)jk#EqjY5gI^3SC/BB&E-a_>hb: f"<2Dl at -7r$>0=Th-gcl!!4Om_#46]2qjf=S(gG2FO?R!95qVF21"NVVpGCT6J8.LOPXj-ZN,s^ /4&'T"JYqs"JuG+8G(1+]`P*_Rf9u;WD*L$_qr8)7PU%(74+G9M\HFhNCfoFs*t~> #ljVdi)'J&e[PJW&j>!:(8'5an"9f]k:RlU4.Ftfr*pgF/3 q.0P=pM'A=!,q[Q!-J$Z#b(;-]=PSMJ=6DJ(og:mI,*MnTg^\tW'r)#\qqeJPa=t;s8RT~> #ljVfj-=\Dl.l5a5+Cr\LW(p Sa50u\+R_tm?,![j7'I=repoLkiD]$.&H at ZQI,*'ZGc(YS?p&lgT&7a!4(Ul!4h:+!5IL4"j,'8g at WYh]`P*_Rf9u;WD-^Bn_V-W7PU%(74+G9 M_qNWS4TLUs*t~> #ljVfj&5q)e_pFc',WmdQ56%C6]BPa9\,f@\kACD3;ih/^Wn2XYNAguIbTh/PU24*=;@U_,u4JZ "*D_U]r+N5fa;?k;/aZs%KHJVc+s8X-lJ,bQI=M\K\=;D- at 3_PZnE]@eHC*r7h^`uQGStYfs:ZC d at dK-P6@W\!!K/)!_Dt.rk/A_'O(LL(o^44#fGN9Rr=_.]rl(1]o*R18rZE;s8RT~> #ljVdi)'J&e_^:a',s*hQkl=H7Zl.j:tMDH]M4mM4oGXk`6^.oZKGO8L>.j=Rk]uD?mM`*1Ksg) '7J3&_6@(Ug)bD:@sZRM,T%@ZdDm(@)]UW&aeIDC?Bj6gZp9Poc+ch8ak%kps(+$SbbWIZA)G$L ?J)Eintdib.etUq0DI4$1&!L)2u5K648(c:5kmVF6MX%M8,#UL9`S#d;#jPi<<-(o=TD_&?2.h. @ejR8BD6-7D#eMME<(+VFU4H+be(HtIhc8g\eqGA4FGr>_4#5-]"4qTNOjroBU"iTV#UIF~> #ljVfj-=\Dl0nVi7>[N$aG/"-TZ?;iV6Nl1>,l-,I5iiS9kl]nLM \q[l[cemh+`WaK0cJ%p8rk/A_'O(LL(o^59bOOH+Rr=_.]rl(1 ]o+_Kadbqts8RT~> #QOMej&5pb2Z5oT$P,0C"Xl;<%m_<=1I4;R"XZ/!#%@="Xu>9'L<`? #rY(8*!e2V!uaH?#<"(;!!!?_1&M#!'fnWH3"HHa5oB\32F/Pf#r+==*^LD=&ii6>(^`2R!!"Q8 5sZdtUAt8sV?d5ooZdBK!j.W]rk/N89`ta>hST'$#`BB&8rZE;s8RT~> #QOMci)'I]2Z5oT$kP?E"tM_G'LO)K2FKq_$8"CVrB[# )+..q0-!2G(G/H3)b)t3(`4Dd6l6a[*#pV-<`VpD.99J,+Y$;k59M at I:*_u-1aFkV>ZWm<<_b%k 9jV1681>r:q()M!pb2\&pG;k/qD\I:p,i=?pd"mHq*b9RpIY*R!)WMh!)rYm!*8hs!*o>*pgF/3 q.0P=pM'A=!,q[Q!-J$Z#b(;-]=PSSOJ;`c#-(B[I,*Mnppp`f-YSa28YlCdJ,~> #QOMej-=\5Qi3EsJV0>MIZTqKKUe!KQCOJ+IZKkKH[^X$S=PIhPG!qhMZ0 at oN.d1_Q%t`uLlS6n KSZ4pUQUP/UlCb at Q&hc6O,T$ZUS@[F,*f%)WMPfBWMu8ERB*NcPaJDMPb>4MPanhYXe(r]W0EOF riZ?uQK"D7UuJ3NX6-MaZJr7l\`^X+^Z!09aj/2coZdBK!j.W]rk/N89jZ$5hST'$#`CO at adbqt s8RT~> "TS2bj&:L/W;lo$V?d5eZ=s#G"_C"'#bueAB*_rZ#YL(JU]:@E~> "TS2`i)01J!!2`qoa(4!pCI<;p(RKBq%s)Np)F&Sp`T;V!%.Cf!%Rdq!&++$!&=4)!&sa6!'Bm: !'p #64Ddj-=\1kBd2XiIh2dj, "TS2bj&:L/W;lo$V?d/,oE,*t#kS3(":.VZ8Yc=cJ,~> "TS2`i)01J!!2`qoa(4!pCI<;p(RKBq%s)Np)F&Sp`T;V!%.Cf!%Rdq!&++$!&=4)!&sa6!'Bm: !'p #64Ddj-=\1kBd2XiIh2dj,e%nG8Yc=cJ,~> "TS2bj&:L/W;lo$LBn&UNCfoFs*t~> "TS2`i)01J!!2`qoa(4!pCI<;p(RKBq%s)Np)F&Sp`T;V!%.Cf!%Rdq!&++$!&=4)!&sa6!'Bm: !'p #64Ddj-=\1kBd2XiIh2dj,i6DMJS4TLUs*t~> "TS2bj.V$]WJU\6LQ)J/QV!tPs*t~> "TS2`i1BUtoni@!oo&O'ooAg.ooSs2pQG35pltK;pQkWAop>`IpR:lHpRLuKq4@;PpRq;TpS.JY p8%GZpne%hpo*5Q"gFFeV#UIF~> #64Ddj0P_bkGnTaiN<0aiiqLLij8]oijSotk.(K'ik#3'kIgl0iP,B.i5,Z5Rn9CTs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj6XGe\q2X_,s%:']t9_grItB1Uq2,jQG*:1s1A6BaLq_F8Yc=cJ,~> "98)_i9\#_[t6=[,rq.!]""2brJ(H2U:5]bJ\'@B"IhuYs8RT~> "98)aj6XGe\q2X_,s%:']t9_grItB1Uq2,jQG*:1s1A6BaLq_F8Yc=cJ,~> "98)aj6aMg\9h)8]=k% "98)_i9e)a[Wt]3\@SG5MR9/3rr2p#rmc=E["5f>]%+ at pRn9FUs*t~> "98)aj6aMg\9h)8]=k% "98)aj6aMeX>YI)S=>aX.&P_trs%f/^uad1F7['MMe6O3KXHu4M7iqRRbGFUU5[^;!PH&-])TAB ][sh"RRs:Ss*t~> "98)_i9e)iW]5=&S!oUW/#Cu!s8VH*_;sd1Eq?jIMIg=/K!UQ-M7N_MRG,4QT8AT>"IhuYs8RT~> "98)aj6aMeX>YHiBk:X7)1pTArs%f/^uad1F7['MMe6O3KXHu4M7iqRRbGFUU5[^;!PH&-])TAB ][sh"RRs:Ss*t~> "98)aj6aMpX>Xjlc-XhA.;c*bqQco;019WaIV/5c#>nTOI:me3FmH^AJr?>9!Fp3)]`Eaag:[O" ]A^=$]\'n#RRs:Ss*t~> "98)_i9e)jW]4dkcHsq@/8V "98)aj6aMpX>WsnUoC>S%j7nPqQco;02%PNIV/5c#>nTOI:me3FmH^AJr?>9!Fp3)]`Eaag:[O" ]A^=$]\'n#RRs:Ss*t~> "98)aj6aMr[A[ZF[`\['F"Z]tM#VZ6Hoo\[/WQ]t:VZ ]tLh\]=GGa\%B8\]sb5R]=G8X]="ql;r#%e]Y!%3!5$pt"I_oWs8RT~> "98)_i9e)lZZr)*mWg0(28;e[UpK(%K4HJoc$X*2p:;/?K=\X=?X at lbZ*:UH]!8KG\[f)P\@T,Q Ydj\D&7oUa[(3WP['6d@\[o/PZ+9kF4L;Q,[CNZKZ+.9M]"55VZ*_*R\?icX[(!TNZamWRYd(aI YdV-S\$`TJ\%9)RYdV*IYd:aB[^ruQYdXMA&[ejJ\%&cQYd_3QZ*7MU]"5BMYTgTg\$<0G]""uN ]"52Q\@/fU[CE`Q]!S]H\@/WM\[&Db;3&3jRn9FUs*t~> "98)aj6aMrZsI0`.jl\g"99(/UP1*,#UGM8gj<\Ep:VAAKtY0G?!h`d['I-R]sP)R]Y(\[]=kb\ ZFg+L&7]Od[_0/[[^*3I]Y1e[[(QCO4LMf4\%K2U[(EoY]tLh`[(!`^]=,Dd\%0/Y[_08]ZF%9T ZFRZ^]"#5U\\5V\ZFRWTZF76K\\5V\ZFKkH&\,-R]">A[ZF[`\['F"Z]tM#VZ6Hoo\[/WQ]t:VZ ]tLh\]=GGa\%B8\]sb5R]=G8X]="ql;r#%e]Y!%3!5$pt"I_oWs8RT~> "98)aj6aMhXg.BkG:uKm55!8s71K.p"WXl9Kk7C\]e3/lNK%ap?Z1cc0N+g]9/',,Ro2A"X_KOD H*k8u?7U%cWH_H5,qr#WTi3X-MZ1:P31Ye+R8kq)L5/R<]f0dWA\5XH3OZM#I>^3^QCLi,5*'q) MS-WR9N=&nZCim*BVm.*;-Q&%WIHTUA$5gE2gmA at H'Kdf0Q!q>4"qk"]tK470JIs`NBT16VM$m* Un0n>N+lXu=HSt5VG]*4MJa\dO%(fJ;r51g]Xuq0!P?#!]`acqU]:@E~> "98)_i9e)mX0V6jGqV]o54d#m96$V;/cYkl[-WEWXS9:Y;IYQBC3!X!M* "98)aj6aMsO_AV[))"Nd'HR5S5W9`ES+;t>[dAc[XnTL];.GTFCiWm$M*E[lVn>YV:6qAI4FsVL 0JIdZ]tI`&E^m$Q<^nAh9U)5L0Kb6l]fe?GL00jD0Kt5H:VFG#D(0&.]q%0l\lX<<4AD-3;D::q GSc7M]n&jW3-2Bu0JI1;-R_hr3HM0L0JI">rk17=0KOKE-t=rJXaE2a,'1H2L_;BqI^P/!1hrn@ 2c6BB6:-WF?`@.iQoq6D0L(G4,^YSA0I'NQ]`GdXgU[Et]\C+&RRs:Ss*t~> "98)aj6aMgPN`&;D(Uj=4PoS.*Voa>/cY9t@^#R?/l=c3XVV)4_20LBL>^IBTdXr-YR0< S%ZLGEM5k$GZI:l]nK`q4D7eKrk1HSSVC6PBYC&tL/5Lr2f2a"]tKss[^oOgC3GSo=?U>"/U1L3 ]tJtTJZ)Y5X(Z/qJO#fJA#idN.;3BEM#P(HQ=sG^IiEmN2h4Sp]jl,s]no1k]fDUUE+;%NCNc)" H=iLq at U4dpE0!%iEP%]<>[jd "98)_i9e)nOm2o9D_ at -A4l,V-*=X4u!!OT!2?*!$A$#I:/lFf2<-YZU>shS&4_)!FAj]RJBp!Xr ->$j9S%?1CDkBOuH!!Rr\q46l4D%SFrjk6OSqU?RC:]rrKi#@l3Ghs!]"4FpZaj.cBm5Ml>!?P! 0R$j6]"3GNJYuV3WFf`jJj>lJ@] "98)aj6aMt6(]DP0J/BU,@)c!&%f19rQoC>2#m$&@^#R?/l=c3XVV)4_20LBL>^IBTdXr -YR0" /U1L3]tJtTJZ)Y5X(Z/qJO#fJA#idN.;3BEM#P(HQ=sG^IiEmN2h4Sp]jl,s]no1k]fDUUE+;%N CNc)"H=iLq at U4dpE0!%iEP%]<>[jd "98)aj6aMgPN`&9\6_3mW8.!F*Voa?/cYkAQX$Kb]`CuarOjUf>Xr at OHCeehH;@MHNF\iE/p_ho Z+[h]EM5k$GZI:l]nK`r7XBB8rk1Y'0eLNm%8 ]tJu'[&@&S>'bKKJO#fJA#idN/H0rWWkH*-@[jd "98)_i9e)oOm2o7\Qq6oVVC^B+YjE*,[$kD7fWMZQX-Nb\cG]]rOOCb>t/@MH(/JcGu%JGN+AZD /U;VjYI_;WDkBOuH!!Rr\q46l7sTB5rjk*KSqU?RC:]rrKi#@l3Ghs!]"4FpZaj.cZ?C8k?:fEf L3Ht7]"3H!Z):]O=a>9HK0YuK@] "98)aj6aMu6(]DW2]Fe:*+L,l"`*6"Y<*3o/cYkAQX$Kb]`CuarOjUf>Xr at OHCeehH;@MHNF\iE /p_hoZ+[h]EM5k$GZI:l]nK`r7XBB8rk1Y'0e LNm%8]tJu'[&@&S>'bKKJO#fJA#idN/H0rWWkH*-@[jd "98)aj6aMgPN`&Ch937GcK!ud*Voa?/cYh(;NJ?`]`CuarOjUf>u[/sH?MN<[<5YgGE,UW8[Ys# U:n6QE41cW:9@*B[=M^nCUK^1rk3WS01D:HB=40iLetKX+)P2_]tL"#Xa1S+;3c3??>[*B9mBmS ]tJu'[&@&H4gh[gJj>oKA#idO412J(PJ+YU?F?:tIlP-T2h=bo[9n!g]no+a[68V7U9%R5>,#qP >EFMGSn)]AO%#sZDmPa0?"0pALUDS0\@^e7!5$al!5..$"I_oWs8RT~> "98)_i9e)oOm2oBh9!+EcK!uc.]Zb`330$#5QC`9;N8*[\cG]]rOOCb?;m,oH?;H:Z?9DhGE,RW 8@#NsTt7gLDmPKT9rgg?Z@?:jD6fX-rjmEN0gq at EBsO*hLJb?S+)P2\]"4IuWd,2(:mH->?uE9? :Np-U]"3H!Z):]F4gM@`K0YuK@]5TW)(- =eKYN>*4DGSRuZ=O at 5pVD6T7*?=Bj>LU)8([^_F1"IhuYs8RT~> "98)aj6aMu6(]D5<`<$_F at o1+!!lr?;??gu/cYh(;NJ?`]`CuarOjUf>u[/sH?MN<[<5YgGE,UW 8[Ys#U:n6QE41cW:9@*B[=M^nCUK^1rk3WS01D:HB=40iLetKX+)P2_]tL"#Xa1S+;3c3??>[*B 9mBmS]tJu'[&@&H4gh[gJj>oKA#idO412J(PJ+YU?F?:tIlP-T2h=bo[9n!g]no+a[68V7U9%R5 >,#qP>EFMGSn)]AO%#sZDmPa0?"0pALUDS0\@^e7!5$al!5..$"I_oWs8RT~> "98)aj6aMgSC[Q(YF1fMS)Edq(Ae(8$!@#A;N^^e!Gdks]bG[FUdZnI]tHuh/S2.s6(klG/M3Ll ]b%YrNLW&C]h'G#=KK)G/O?H:]b%_5S at uRL/OZPLIP$X_J9%mn]c!Y&@;h++6/M0>M=M;CLTU7tr2MAcWL_23jT=p1F/No/i3FTV7 9M24rH\/r,=hVLY/k2[kGeL%P/MCpSPiTLX]@4=l]=d"6"I_oWs8RT~> "98)_i9e)mRb.E&Y*kWHRbmLl2lh?e#;fR_AGEu?PP;WhCQSM+'Qo/+6nW&^\jn>(AZfQ0T"0P, /XcUL&@?Pcb5@/OHXr FLeuoNc_V.Djm6r/I[\GUkEroE0d.K/Uk5/\iG-i/OGJ!]"2";QU!,\KY"aO&M5T*\r/X%4H6'p ?b3gC8YiqEJ at _OX]"2E)7APW\\u&:U/o,0aOLbRa8YlCdJ,~> "98)aj6aMd>)bX0Lma[&Md$&Z$4&\/5o:/8q8?0npUpTCP5W'.GD;n^/nM`08M)N*Y[g%m]SA'j SGp25[s!b$3k`3u,;!$!\n3N[X8]dD\Mp%l]P/rcW4RL1OB6sQYl;[n\cKFUhRs&\8Yc=cJ,~> "98)aj6aMh\Y[[Kl+":,gZsT#BG17D"qYP6\R1K3fY%NsKOel3]h+.V]`X1.A#ciJ!Js7Y^!aIm ]=d"6"I_oWs8RT~> "98)_i9e)m\"qCHlF4:+gZaAsSolmr!!!RGkdb#]\_+IuZ%HV&]"1FlpUUHaBk=9L\cI^ZJ\(*W "IhuYs8RT~> "98)aj6aMsZZ(=]3dlC-<<*"eBG)P$E`PbXl+(/`]\'n&["Mt*]tI!qpUpZeCLaBM]`EsY]tMk* !P?#$]`acqU]:@E~> "98)aj6XGo\#R[LnD39kI8,pfZ#LE[@'AS*;jc.L#ITPC\%TJ=X7s:/PBsL=]`G-q^:aNYdCK=j hRs&\8Yc=cJ,~> "98)_i9\#i[A_:FmbHsgHqophc$'g(?a&J' "98)aj6XGoY'G7e/m^pM!&p,(Z$eS`Ej+K<;jc.L#ITPC\%TJ=X7s:/PBsL=]`G-q^:aNYdCK=j hRs&\8Yc=cJ,~> "98)aj6OAl\Y[FGo#Q)DXL4bin_)I[pU "98)_i9Rrf\#%.CnATT "98)aj6OAlZ?1:o.UrrHXL4bin_)I[pU "98)aj6=5gU "98)_i9 at faTZQMeE^74I\"MLQs6ZRaWI_X3]%+ at pRn9FUs*t~> "98)aj6=5gAUIDV!C=E4\t at aSs6c[cXF\'b^!O=j]AC4(RRs:Ss*t~> "98)aj6F;^Z**'OW4bLr]`tmDakiJ!U4L"W^!O=j]AC4(RRs:Ss*t~> "98)_i9IlXYH6[JWk1Oq\d#I=b2&ItTRj\*]%":oRn9FUs*t~> "98)aj6F;^SSiO'!!,Cb]`tmDakiJ!U4L"W^!O=j]AC4(RRs:Ss*t~> "98)aj6F;^TYUTnW4bLq]`b^6O+j?[]r8Wk\cBA!]`acqU]:@E~> "98)_i9IlXTtUKlWk1Op\cf=0OG9K\\q.HA\ceKoV#UIF~> "98)aj6F;^EI)9u!!,Ca]`b^6O+j?[]r8Wk\cBA!]`acqU]:@E~> "98)aj6F;^\8l`5W4bLp]`P^K[t25j^!O=j]AC4(RRs:Ss*t~> "98)_i9IlX[<$H2Wk1Oo\cT:B[=Po?]$e.mRn9FUs*t~> "98)aj6F;^Y@/+F!!,C`]`P^K[t25j^!O=j]AC4(RRs:Ss*t~> "98)aj6=5\Z$WIK]g8j8q7M9lq7Qd?dCK=ihRs&\8Yc=cJ,~> "98)_i9 at fVY'R.K]0LqYJ\'"8"IhuYs8RT~> "98)aj6=5\UfA$-!C "98)aj6F;^Z**$NW4bL$]`PjY]D9&5]DfIh^&G[W]`>[l\cBA!]`acqU]:@E~> "98)_i9IlXYcQaJWk1NI\q.H8\ceKoV#UIF~> "98)aj6F;^So/X)!!,Bi]`PjY]D9&5]DfIh^&G[W]`>[l\cBA!]`acqU]:@E~> "98)aj6F;^ZA"^pW4bL&]`GdXl+6`'rk/6Drk.4%r42p@]YD,[][=:j]AC4(RRs:Ss*t~> "98)_i9IlXY_JOmWk1NI\q.H8\ceKoV#UIF~> "98)aj6F;^T4]SQ!!,Bk]`GdXl+6`'rk/6Drk.4%r42p@]YD,[][=:j]AC4(RRs:Ss*t~> "98)aj6=5\Ugp'r]g9! "98)_i9 at fVU10gr]0LqYJ\'"8"IhuYs8RT~> "98)aj6=5\UHAMV!C='*!PH&$])K=n\cKFU_7]i]dCK=ihRs&\8Yc=cJ,~> "98)aj6F;^\#@jCW4bL']`>[I\cBC[]`GdXd^fFjhRs&\8Yc=cJ,~> "98)_i9IlX[ADC=Wk1NI\q.H8\ceKoV#UIF~> "98)aj6F;^Y%`,J!!,Bl]`>[I\cBC[]`GdXd^fFjhRs&\8Yc=cJ,~> "98)aj6F;^TV^u?W4bL(]`>^H\cBC[]`>[m\cBA!]`acqU]:@E~> "98)_i9IlXTr%&?Wk1NI\q.H8\ceKoV#UIF~> "98)aj6F;^ED8Xt!!,Bm]`>^H\cBC[]`>[m\cBA!]`acqU]:@E~> "98)aj6F;^Z"o*NcAY&s]`GdXXL\DD_S#r^d^fFjhRs&\8Yc=cJ,~> "98)_i9IlXY\f'Mc\au=\q.H8\ceKoV#UIF~> "98)aj6F;YSiQcM! "98)aj6=5\UK;2Z3hs*r!PH%F\cBC[]`>[n\cBA!]`acqU]:@E~> "98)_i9 at fVTiGiV4J78:J\'"8"IhuYs8RT~> "98)aj6=5\U,r>T*2BpT!PH%F\cBC[]`>[n\cBA!]`acqU]:@E~> "98)aj64/YW_tp]kIh)!S!oeDX01m("M1M5XLml5!5-jns,ksF!kXY[`4Z2a]@=Cl]\^=)RRs:S s*t~> "98)_i97`SW)Gg[kILYkrg3b_WN5Hu"Lk5-WOTaTs,kpEs,hlDn[\jm8YlCdJ,~> "98)aj64/YW_kdZkIh)!S!oeDX01m("M1M5XLml5!5-jns,ksF!kXY[`4Z2a]@=Cl]\^=)RRs:S s*t~> "98)aj3#%>;):a6EIWl6]`bH+ at pcV1]`>^q])R00])R5s]`>^p\cBD"]`acqU]:@E~> "98)_i6&V8;DUg5E.<]3\cf''A6uOV])R00])R//](*?7Rn9FUs*t~> "98)aj3#%>;):a6EIWl6]`bH+ at pcV1]`>^q])R00])R5s]`>^p\cBD"]`acqU]:@E~> "98)aj3#%9;2+8J"Kb+&?aTaE!@g>5]b!CXBe#=[]kJs1.VQE)OXb&?\cAW,4r+mE\ir "98)_i6&V3;M45F"KP"&?EsF>!@g;4\e%%TBI].U\nER,.VQE)OXb&?\cAW,4r+mE\ir "98)aj3#%9;2+8J"Kb+&?aTaE!@g>5]b!CXBe#=[]kJs1.VQE)OXb&?\cAW,4r+mE\ir "98)aj3#%9;2,"_)LQR45bsMm.uUH$]tL@/]kMrp]a-j$ IX\sp]tHZ*]`>^s\cB at u]`acqU]:@E~> "98)_i6&V3;M4t[)LZU45G=2h.Z:99VLEchCRpeA.YXllA6s5*rOW#V'"TR(OaO`(\l4a&;n>0( O]/hipq$KQs1/2Drji4r]"39:rji+oI/UV_BRID&VGk(;I!kk'+[2d7\nI5;BRID&VEVT&5.\=f Oh/,;Oh/+f]"39:]"2SS])R0U\e at 9)]"2R;\j!]QI(DMQ\j!^:OcfFM#\\Us\u%[&BRKfj#X5,5 I(DMQ\j!(("IhuYs8RT~> "98)aj3#%9;2,"_)LQR45bsMm.uUH$]tL@/]kMrp]a-j$ IX\sp]tHZ*]`>^s\cB at u]`acqU]:@E~> "98)aj3#%W;&^fSVeTLAKq:#dQnsFeQtp6$<0jkXQoKaf at pcORr4NbCP:Dbq]tICY5?*hq]mZ&B 5.X\e\cZVnHt`Mj"?sE.I!kq)!'^=lr&t6s]"39:r42kCrB::F\j#u%"HdAFBVtd?"$X;0OoDoo BRG2 at rji,YIf-kZ(&^?,PJ'2oIX\sp]tKVDIVGbU]`::o]`::q^& "98)_i6&VQ;B-uUVJBFAK:=Q[Pr44eQ>0rt "98)aj3#%W;&^fSVeTLAKq:#dQnsFeQtp6$<0jkXQoKaf at pcORr4NbCP:Dbq]tICY5?*hq]mZ&B 5.X\e\cZVnHt`Mj"?sE.I!kq)!'^=lr&t6s]"39:r42kCrB::F\j#u%"HdAFBVtd?"$X;0OoDoo BRG2 at rji,YIf-kZ(&^?,PJ'2oIX\sp]tKVDIVGbU]`::o]`::q^& "98)aj3#%9;2,"_"_q=JLn5I_71bPO?s6Z9b1]`Dhr rk/D_]kMrp]a-j$IX\sp]tHZ']`>\!\cBCu]`acqU]:@E~> "98)_i6&V3;M4t["`%@KL79"Y6kGDO at 9m)B "98)aj3#%9;2,"_"_q=JLn5I_71bPO?s6Z9b1]`Dhr rk/D_]kMrp]a-j$IX\sp]tHZ']`>\!\cBCu]`acqU]:@E~> "98)aj3#%9;2,"_)/_e5BDN6Tf]g@??@pcV?]aJOR]i9Ho]r2[ZP<]&[""KGE (&b]FOT8>Z\cdCE;a*DE\dN1$5!CHY\ipim5*>iU"B-d65*>iUr]V)r]"4ag5!DoB]"1fi5!G+? \ggWB.]30U!>VL2\d3[I;a*CV]">ZT58I53]r3DF5?+Rq'kr+H]g$5E.TAV^W;aI3P5nS\]a%Ld 5_$\cBCt]`acqU]:@E~> "98)_i6&V3;M4t[)/EJ_L7:*4\oaN_>DA&ADN-We\j:p;A6uP<\dN1M\l4!f\u$4ROZrcU""KGE (&b]FOT8>Z\cdCE;a*DE\dN1$5!CHY\ipim5*>iU"B-d65*>iUr]V)r]"4ag5!DoB]"1fi5!G+? \ggWB.]30U!>VL2\cdCE;a*DD])Fl/;nBQ;.R$$pVJ$]XHn)]kBY#Zl4tnpRn9FUs*t~> "98)aj3#%9;2,"_)/_e5BDN6Tf]g@??@pcV?]aJOR]i9Ho]r2[ZP<]&[""KGE (&b]FOT8>Z\cdCE;a*DE\dN1$5!CHY\ipim5*>iU"B-d65*>iUr]V)r]"4ag5!DoB]"1fi5!G+? \ggWB.]30U!>VL2\d3[I;a*CV]">ZT58I53]r3DF5?+Rq'kr+H]g$5E.TAV^W;aI3P5nS\]a%Ld 5_$\cBCt]`acqU]:@E~> "98)aj3#%9;2,"_)JWP_Lp_7T/SqeU=K8Z4K=5tU/J*M&@pa2-m(ED2\[hg=;tdd&]XkcW]Y!UC !5%m7!5.%!"I_oWs8RT~> "98)_i6&V3;M4t[)J`S`L9kqQ/T.hQ=/W9/J[9VR/J*J&A6s8,UUgK';h;O?\ceKoV#UIF~> "98)aj3#%9;2,"_)JWP_Lp_7T/SqeU=K8Z4K=5tU/J*M&@pa2-m(ED2\[hg=;tdd&]XkcW]Y!UC !5%m7!5.%!"I_oWs8RT~> "98)aj3#%9\@_aRrj`NN]t:\[]"P_d]Y1kf]t=9O!P5f?\H'5-]`GdX]Xe3-4t8&V\cB at O]`>\6 \cTLV]D&l;]=ch1"I_oWs8RT~> "98)_i6&V3[^c=J&\#3W\@T2UZF at ET[^iuX\@T3LZ2qJCrjDg9V7Hbk4t8%5]&U@)Rn9FUs*t~> "98)aj3#%9\@_aRrj`NN]t:\[]"P_d]Y1kf]t=9O!P5f?\H'5-]`GdX]Xe3-4t8&V\cB at O]`>\6 \cTLV]D&l;]=ch1"I_oWs8RT~> "98)aj-74X]XtDZ!5#YP!PH&9\d#dZ]tM(j]D]>@])]Lq]`acqU]:@E~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj-74X]XtDZ!5#YP!PH&9\d#dZ]tM(j]D]>@])]Lq]`acqU]:@E~> "98)aj-%(W]Xte_\cKFU[(QOR]=[dJ!P?#C^%o=l]`acqU]:@E~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj-%(W]Xte_\cKFU[(QOR]=[dJ!P?#C^%o=l]`acqU]:@E~> "98)aj,q%S]`5UR\cB at H^&PbF]DT8?])]Lb]`acqU]:@E~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj,q%S]`5UR\cB at H^&PbF]DT8?])]Lb]`acqU]:@E~> "98)aj,1PL]_]7\\cTLV]WAgB]Z7\gRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj,1PL]_]7\\cTLV]WAgB]Z7\gRRs:Ss*t~> "98)aj+4oD^&G\?]Crhq]DfHo^#m!2RRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4oD^&G\?]Crhq]DfHo^#m!2RRs:Ss*t~> "98)aj+4o9^&G\B]DfHo]u7SeRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4o9^&G\B]DfHo]u7SeRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj,UeR]Y!I?!kZ+XJ\A\/"I_oWs8RT~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj,UeR]Y!I?!kZ+XJ\A\/"I_oWs8RT~> "98)aj,^kR]]Qd+]=`^.]Y+H:8Yc=cJ,~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj,^kR]]Qd+]=`^.]Y+H:8Yc=cJ,~> "98)aj,gqS]]6R']Rdc0]`acqU]:@E~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj,gqS]]6R']Rdc0]`acqU]:@E~> "98)aj,gt6\cTLVT`0NCO6sU`\Q:ZBbF&!j\?)qRlp!XT#mPUP"/VZb3)cJr-h5 Lk:5:ZFm&dK!;r%V1jc+rOiE&Y.^lmKVc8n"I_oWs8RT~> "98)_i.8K.\cA?$J,kPq\cfI-J;Lhr\cnb$]"5)0rji08R^;k%!L]te\f7>oJ;LPAU4 at cLYc!5+ J;LJ?Uk!uu]"4YhLT(0_#*uC&W/#u!]"/$68YlCdJ,~> "98)aj,gt6\cTLVT`0NCO6sU`\Q:ZBbF&!j\?)qRlp!XT#mPUP"/VZb3)cJr-h5 Lk:5:ZFm&dK!;r%V1jc+rOiE&Y.^lmKVc8n"I_oWs8RT~> "98)aj.s?kBg5RGPOlHf]_K&[UrHEGdaB?u;s>?=7/QXIX$4?>-;:]a%&fWG,[HB:HNH"I_oWs8RT~> "98)_i2!peBKf at BOm0FWB^3/0 at lXHo!.=4G"G9ud??bD?"__ba\s>S[\cS9tUADG):kcKlQt-,% !c"<4ra$4WDE1s.CoO.7?=%3DS7c/7C8Lp@#=acPBjG%WR_--6Rn9FUs*t~> "98)aj.s?kBg5RGPOlHf]_K&[UrHEGdaB?u;s>?=7/QXIX$4?>-;:]a%&fWG,[HB:HNH"I_oWs8RT~> "98)aj2en69`@!OK(ckZ[\>\c=q[\d#fYE4rrO546)e??a)hQK,X_L0\>N ]pLq]]`O[$V>S"@]749aVS.4\]Y1_=M+bOq[[M;D\Gj/LMb1UqQEu$I[C2X1rk/P,Ng "98)_i5iJ0:&['OJG-PUZ[.f)])QFF\u$t@\c=qZ\cl_a]"4.lm^`O+G.OuCj15GL?Xo,-Q9YA[ !gur\r43TPIpu-L\p%Di]!@QU9tIpBR<)]CrjiJs8 at lBsZ$p&d[%+;u\d(]cPuFHfT;T<4"IhuY s8RT~> "98)aj2en69`@!OK(ckZ[\>\c=q[\d#fYE4rrO546)e??a)hQK,X_L0\>N ]pLq]]`O[$V>S"@]749aVS.4\]Y1_=M+bOq[[M;D\Gj/LMb1UqQEu$I[C2X1rk/P,Ng "98)aj2en;1lnZ:@XRp`!jZ*an\#]&W4fm.W08][]kJ4p]otZFBiHRZ\u,Hj"FRelOVRjZrji)W r]UUb]"4ag5!Dnmrjjr!A7_d at N(Ib*Od%gOA#3^uRmM+9\4*1+]k2;bXhDES9.!)tE[bg1S\'2_ YS"4Zt+2EP.GmE]`,SFMG*o]&:IQUXgc!*9rb5(]nBgi XLJ/A#"O]B "98)_i5iJ52N=Z6@!q^[!jH!^n[]K"VRj@$VNE?U\nDhi\rf0?BN$CX\u,Hj"FRelOVRjZrji)W r]UUb]"4ag5!DnmrOOdsA#Q>`8noH2P;sptULK:S6uR.T7\I?(A9"QJ]"5+?,t4;E.;`@\\9M\g 5UB7$A1ic9\d,T[A7g(pQ9YA[!gur\r430>A9(##[s))frji,d:&VX7HWR#C[CVJoW2R/9KOCOS [/IQ?7ZWs=Q)M""\ceKoV#UIF~> "98)aj2en;1lnZ:@XRp`!jZ*an\#]&W4fm.W08][]kJ4p]otZFBiHRZ\u,Hj"FRelOVRjZrji)W r]UUb]"4ag5!Dnmrjjr!A7_d at N(Ib*Od%gOA#3^uRmM+9\4*1+]k2;bXhDES9.!)tE[bg1S\'2_ YS"4Zt+2EP.GmE]`,SFMG*o]&:IQUXgc!*9rb5(]nBgi XLJ/A#"O]B "98)aj2enN2kRds@Z'?Z0n*?"n)a32!suZY;BbPeC%$ Kk""aBru*!Wb$Q at C5#bn>&O>Q%&nr[]Y/o'Z`.&hQotA]!h3)ar4NAg;n]h&TQjeUrk/>i9DuO9 I4.$FQ+ahe3&l2i]n\a8Ej5PV#=jffPXdcLWOohHRRs:Ss*t~> "98)_i5iJH3Lm[l@!9,dKnH&/[#BX*Y$QC6KU89_XnTC7VGf[+Oh/,OI(HmQrON"EVZ"(35,Pp& BT]m;55_tmVEY!j#X5i25,Pp&BRKci11DCc2c at .oEj.g"\nGMhDfoB!CplBr]"5+Y2a`b>;d+f_ ;I!n8Bn!!kH9Z+r=BSmIrjiN8K;Q2jJ6]=V=H8\3rji0!;PO*##_>ja\N-4)>e0jF!JjJK\e09< 2FitB\VE+&Gd4i64@!tjrji>(O1LKD3GGD'\ceKoV#UIF~> "98)aj2enN2kRds@Z'?Z0n*?"n)a32!suZY;BbPeC%$ Kk""aBru*!Wb$Q at C5#bn>&O>Q%&nr[]Y/o'Z`.&hQotA]!h3)ar4NAg;n]h&TQjeUrk/>i9DuO9 I4.$FQ+ahe3&l2i]n\a8Ej5PV#=jffPXdcLWOohHRRs:Ss*t~> "98)aj2enO.T'S]AXKT9?!Ug.Z"mWLKjA7G=C#*8A$#I=!0dDq#="EcIX\uD5Q/7q5Q8=t]=JaU 4p-qY\j$&'!IQBq56&1o55Dbk]4Gs\]b.kbEjJ$&]kM;U/KhZ>CUc?sr4OGJ35&9W?!VnhBt^*' JOR7993khV?#I?h]UN2q]Y/nX>?3eIQotA]!h3)ar4NAf.UZU5TQjeUrk/>i9DuO*I9jAZ]`C0a rk/B2;Nq*n!Cr1L]`P]OHFpinRRs:Ss*t~> "98)_i5iJI/5KSYA='?5>[1R)YA.9dJmWH-]"+25Qas\X3E]?CNg;p/\cS9tUAVS.J14f2.\1cg\c0/@Le[iZ!de7^qRQ\fSGp)$ V,WTV\cG9]rji0=@!fMs"IhuYs8RT~> "98)aj2enO.T'S]AXKT9?!Ug.Z"mWLKjA7G=C#*8A$#I=!0dDq#="EcIX\uD5Q/7q5Q8=t]=JaU 4p-qY\j$&'!IQBq56&1o55Dbk]4Gs\]b.kbEjJ$&]kM;U/KhZ>CUc?sr4OGJ35&9W?!VnhBt^*' JOR7993khV?#I?h]UN2q]Y/nX>?3eIQotA]!h3)ar4NAf.UZU5TQjeUrk/>i9DuO*I9jAZ]`C0a rk/B2;Nq*n!Cr1L]`P]OHFpinRRs:Ss*t~> "98)aj2enO/oH8m at uHm*3BJ1.X\Cl$=C#K)Y]a2E5,Pp&VNLkh!k`)`rk0nq@T"SiFE,Tc)UK0I)[(X/"NP1lB ]i9TrS9SCT]sE8aR(Y\M]od\IDYh$PU0r7uJp:UZ4T<"qRo6*]]`Fp'rdk]+BP(S`]r>Is9>/$@ CM@(ark/]/D8!VDS<83/Vc&`X]a%&fU2m?F@!]Gu"I_oWs8RT~> "98)_i5iJI0l2Aj at Z-a)3'&",X%k]"=C,Q*X`[pZ2k0TR$U1H!\nHK&Ht^+&.fHpY55_tm5,S=j "/`Z at 55r+qVRiWgrjiB4]"1)&]"4c$rON#BDZ74!\7'E^5b5K"@;]t(@A$[`J$HSrH&K8*2nDq; \XIbOBY(Hu:mS[XQ+E'(?>o\O#bYUNJ:MfLM*M!N!gur\rON$*:B#bTG%YDl\[n\JL/#7jWbcBU [f3iGRqoUH3Ll4Y[A?ibrji>(O.gWp[:"?n\ceKoV#UIF~> "98)aj2enO/oH8m at uHm*3BJ1.X\Cl$=C#K)Y]a2E5,Pp&VNLkh!k`)`rk0nq@T"SiFE,Tc)UK0I)[(X/"NP1lB ]i9TrS9SCT]sE8aR(Y\M]od\IDYh$PU0r7uJp:UZ4T<"qRo6*]]`Fp'rdk]+BP(S`]r>Is9>/$@ CM@(ark/]/D8!VDS<83/Vc&`X]a%&fU2m?F@!]Gu"I_oWs8RT~> "98)aj2enO2kRds@?tf,Y]a\c08[Vc>$% XM(l3-:F>BE4rrY6G:(95p]:#B6F'a'U`.&]tL7>L_h?`.toW$,r:@jS3d.f+/;r/DC-YiQ*kQW ,rM!<.4$9%TXJth-&oIDFXf1t\Gj/H;3JJA1b!LR]=e?98Yc=cJ,~> "98)_i5iJI3Lm[l@!8&"TV\3^7$"0P>@(l-X`[pZ2k0TR"?oaJ.T?>X$7\5'.R(G+4r$7FrjiB4 .R$$pVRj@#r]Uj?]"*2<5!EVi\u$r at 5#\?W\cH\krjiZNBm at +L3$ht+@#g^E\k[LZrjiuC<$aN( \un^Q7%/.7]"4M%]"4t-,u:1JFo&Z`QX$E!\tW)X(F:@WKJ4Sr15_*9 1mNM=,UGODZZ at E=Mmp$7.PlU_rji>2PI>ut-uuZ+\ceKoV#UIF~> "98)aj2enO2kRds@?tf,Y]a\c08[Vc>$% XM(l3-:F>BE4rrY6G:(95p]:#B6F'a'U`.&]tL7>L_h?`.toW$,r:@jS3d.f+/;r/DC-YiQ*kQW ,rM!<.4$9%TXJth-&oIDFXf1t\Gj/H;3JJA1b!LR]=e?98Yc=cJ,~> "98)aj2enO2kRds@$Y]+Y]a "98)_i5iJI3Lm[l@!8AIK8*Qj$bc,X`[pZ2k.(`"0%#VQ%?Nq\ceKoV#UIF~> "98)aj2enO2kRds@$Y]+Y]a "98)aj2enOGHJQlNL.>\?!EB&Z>!NILl7=B[[;ucFfXK7s1AEF]Y*gK!5/-=!5.d6".`YZ]7IZE ]`acqU]:@E~> "98)_i5iJIGH8Zm&sY at q'AL5M" "98)aj2enOGHJQlNL.>\?!EB&Z>!NILl7=B[[;ucFfXK7s1AEF]Y*gK!5/-=!5.d6".`YZ]7IZE ]`acqU]:@E~> "98)aj+4o>]`GdXrON$A]Rdc/]`acqU]:@E~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4o>]`GdXrON$A]Rdc/]`acqU]:@E~> "98)aj,:T%]8\`qEk%l/+WVkbW\YkG/9n_(EkJo06Rtp-E$QJK7D!Da]=j2 "98)_i/>/t\;W?mE4)H*+WVkbW&,_F/9nV#F1Sf-6Rts,E?cMK7(@)\\@RT4Ye%E<8,g(#8>6$o 0kc$GRO0=,J at C\NUq3F2S<6j`= "98)aj,:T%]8\`qEk%l/+WVkbW\YkG/9n_(EkJo06Rtp-E$QJK7D!Da]=j2 "98)aj,:T%UeRPrHAB2ILI]%kWCN\rZX/6V27m%;]=j>O[]!8j]t7]n]=jJ=S%Z4b<;sQ_2g_sG VFc!)34ll;2j]LA9=^otRYaJH]rFSs]sM*s]t8Pn]/5ti]k22W8#cL$#.?ae]msarMS0.]8Yc=c J,~> "98)_i/>/tThV2kG_`lAM+P:iVFdGlYZu^L34W:>\@RcFZ_poe]!u0h\@Ri5R_#h[;uX?[2g_jA UdoU"3k2c43LPgE9t$fqR#=JG\u8/l]!5Oj]"!#j\Mp"h\nGrR8Z)Ku#.$Ob\pe at mMRiq[8YlCd J,~> "98)aj,:T%UeRPrHAB2ILI]%kWCN\rZX/6V27m%;]=j>O[]!8j]t7]n]=jJ=S%Z4b<;sQ_2g_sG VFc!)34ll;2j]LA9=^otRYaJH]rFSs]sM*s]t8Pn]/5ti]k22W8#cL$#.?ae]msarMS0.]8Yc=c J,~> "98)aj,:SPUeRQ\]b#rh]tLC8U:mm>JtP!5>'[aY]aq&CP.eJ9EkB#uQ"H),B<_BK/N+ZC]k7k" TK'Qs]f2:;2c>m;;OWG2]tLF9U:mp?J\A[@>.ZV[]tJ#rU.;3^]`to0S\;U?H]#K>RRs:Ss*t~> "98)_i/>/JThV3X\e']i]"4b1TXq at 4J=S[1>^e)e_]"2QlTLl$[\d#K*S[u:;H&B09Rn9FUs*t~> "98)aj,:SPUeRQ\]b#rh]tLC8U:mm>JtP!5>'[aY]aq&CP.eJ9EkB#uQ"H),B<_BK/N+ZC]k7k" TK'Qs]f2:;2c>m;;OWG2]tLF9U:mp?J\A[@>.ZV[]tJ#rU.;3^]`to0S\;U?H]#K>RRs:Ss*t~> "98)aj,:SR[<>#)K`8XrLI]%kW at Bhl6YWNm27m%;]D]DJW)o.q]4#`lrk/E*>]?hD]f.lVCOT\Z GG$q-]tH at kNETM"VG`k>7D6C78#!](?@ff%H!7g21dF<1US9V+6$^)N5FoL!?$hIB"I_oWs8RT~> "98)_i/>/LZ?A`&KDrFnM+P:iVCXVi6><\G`uDVc]%l\7'Efrji3%?#QbA\i2QTBma>U G+Lb)]"0niN*9J"UJmP<8%Q:18>!Ju?%9GqH!Im51d=31TV+/%5^9iG5FoBp?[7O?"IhuYs8RT~> "98)aj,:SR[<>#)K`8XrLI]%kW at Bhl6YWNm27m%;]D]DJW)o.q]4#`lrk/E*>]?hD]f.lVCOT\Z GG$q-]tH at kNETM"VG`k>7D6C78#!](?@ff%H!7g21dF<1US9V+6$^)N5FoL!?$hIB"I_oWs8RT~> "98)aj,1Md[\fd/I_EFM8%lU86&VJ,@#CU7]39KlrOiH7=-C8/@<0!Z]`P`MI/LZ:3.Xt5 at pXAP 34ll;2j]M-TP.n4RYaJH]rFSs]sM*s]t8Pn]/,,7U18MD7$47J]s^.r]t.KrMS0.]8Yc=cJ,~> "98)_i/5)^Z_O1%I_*+I8\2L16]%J(?\k74\QjEirON63=HL,(@ "98)aj,1Md[\fd/I_EFM8%lU86&VJ,@#CU7]39KlrOiH7=-C8/@<0!Z]`P`MI/LZ:3.Xt5 at pXAP 34ll;2j]M-TP.n4RYaJH]rFSs]sM*s]t8Pn]/,,7U18MD7$47J]s^.r]t.KrMS0.]8Yc=cJ,~> "98)aj,:Sr\"U7D at W];sLI]%kWCN\rZX/6V27m%;]=kAD];Seo]t7]n]DfJF\QsU\]e)47LKCTa GG$q-]tH at kNEWBe72q\P7D6C78#!](?@ff%H!7g:R_?CHDk]b$rk/NE5FoKb@>p)W"I_oWs8RT~> "98)_i/>/l[%=V8@\@S`9\>NGj]!u0h\Gj&@[U+:X\h,k4LK^`` G+Lb)]"0niN*<3`7NIkS8%Q:18>!Ju?%9GqH!Im=S%?1ED4jItrji "98)aj,:Sr\"U7D at W];sLI]%kWCN\rZX/6V27m%;]=kAD];Seo]t7]n]DfJF\QsU\]e)47LKCTa GG$q-]tH at kNEWBe72q\P7D6C78#!](?@ff%H!7g:R_?CHDk]b$rk/NE5FoKb@>p)W"I_oWs8RT~> "98)aj,:T#YA%K[AWJl]t7];B4uk%\QsU\]a-TgT7sXY GHGHUBI[,_NEWBkEAX, at 7D6C78#!],Ipcr'@>;EOR_?CHDk]=!BP "98)_i/>/rXD)0VA!FR9M+P:iVFdGlYZu^L34XcOAnGJ#[AR,g]!u05AS-Fr[U+:X\d16dSqXIT G,f3SAh$o\N*<3eE&F#@8%Q:18>!K$I:$Su@"u3NS%?1ED4j!qAnIF90NMdmO,:FNRn9FUs*t~> "98)aj,:T#YA%K[AWJl]t7];B4uk%\QsU\]a-TgT7sXY GHGHUBI[,_NEWBkEAX, at 7D6C78#!],Ipcr'@>;EOR_?CHDk]=!BP "98)aj,1MPXFkhkrk05MPJ+ZG ]s "98)_i/5)JWIfDcrjj#IP.J62P-MU,RAI-H]"3uKH&], at Z^7`(\XWSD"H9XsR\]km!K=8^\c\@p ]!20Z+JlZLR'aH1QEI3M]"583Z+ at NPNHof2]"3j(]"4H)Z&&C)"eW8VH$P^3\ceKoV#UIF~> "98)aj,1MPXFkhkrk05MPJ+ZG ]s "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj,gqT] "98)_i/kMM\:Lg.XoZ,Je%,[O8YlCdJ,~> "98)aj,gqT] "98)aj,gqTY\&GXcq+:RcI^OY"I_oWs8RT~> "98)_i/kMNY\8S[cq4 at UcIC=S"IhuYs8RT~> "98)aj,gqTY\&GXcq+:RcI^OY"I_oWs8RT~> "98)aj,gqUYYmZ9OO9-kYjL&k]`acqU]:@E~> "98)_i/kMOYZ*f;OO9-kZ0]uh\ceKoV#UIF~> "98)aj,gqUYYmZ9OO9-kYjL&k]`acqU]:@E~> "98)aj,gqWYZ#D'`. at s;rrVcZf at .D9RRs:Ss*t~> "98)_i/kMQYZ5P)`I\' "98)aj,gqWYZ#D'`. at s;rrVcZf at .D9RRs:Ss*t~> "98)aj,gqXYZ#C[ZMoFTeGfU at maoq$"I_oWs8RT~> "98)_i/kMRYZ5O]ZMoFTeGfU at mF9Ur"IhuYs8RT~> "98)aj,gqXYZ#C[ZMoFTeGfU at maoq$"I_oWs8RT~> "98)aj3#%>Q`7[3V45-h]`GI!rk/>lZ/`M$YZ#C[ZMoFTeGfU at maoq$"I_oWs8RT~> "98)_i6&V8Q)D4)URJab\cK$orji,hYN*1tYZ5O]ZMoFTeGfU at mF9Ur"IhuYs8RT~> "98)aj3#%>Q`7[3V45-h]`GI!rk/>lZ/`M$YZ#C[ZMoFTeGfU at maoq$"I_oWs8RT~> "98)aj3#%>;2)]sH "98)_i6&V8;M2QlG[IuP\d"]KHFg[HS)_'`YZ5O]ZMoFTeGfU at mF9Ur"IhuYs8RT~> "98)aj3#%>;2)]sH "98)aj3#%>;2)]sH "98)_i6&V8;M2QlG[IuP\d"]77_6/iS)_'`YZ5O]ZMoFTeGfU at mF9Ur"IhuYs8RT~> "98)aj3#%>;2)]sH "98)aj3#%e;2)]sHuWD>Z#_HMGdd:Y"gCpB F0bdrs4%&Mo'Y,Y]`acqU]:@E~> "98)_i6&V_;M2QlG[InI7lR3I?7%FkHR "98)aj3#%e;2)]sHuWD>Z#_HMGdd:Y"gCpB F0bdrs4%&Mo'Y,Y]`acqU]:@E~> "98)aj3#%e;2)]sHGF!D]qg0s6ZP6"?Z`P=Ajpi^7#prR"gCpB F0bdrs4%&Mo'Y,Y]`acqU]:@E~> "98)_i6&V_;M2QlG[IXrF.6TW6$dB5 at 9p:P\t(d=>bX-G\tORj6ZY8t?urJ:Ak$l\6AtNJ"gD!D F0bdrs4%&Mo'OrU\ceKoV#UIF~> "98)aj3#%e;2)]sHGF!D]qg0s6ZP6"?Z`P=Ajpi^7#prR"gCpB F0bdrs4%&Mo'Y,Y]`acqU]:@E~> "98)aj3#%e;2)]sH "98)_i6&V_;M2QlG[ItaH"XO(2.C*@DdBc^\t(gkN`mTqRqH564**El?urJ:Aj'F1Dl!';"gD!D F0bdrs4%&Mo'OrU\ceKoV#UIF~> "98)aj3#%e;2)]sH "98)aj3#%e;2)]sH "98)_i6&V_;M2QlG[IUsN.P)LA%8RQBO/$W\t(gl\j6msJ6oLX=*$C3?urJ:AmV[CEgZO2"gD!D F0bdrs4%&Mo'OrU\ceKoV#UIF~> "98)aj3#%e;2)]sH "98)aj3#%e[88.q "98)_i6&V_ZVMkn "98)aj3#%e[88.q "98)aj351;]V54Q!2 at cP"L(gATZ_ode,KL?maoq$"I_oWs8RT~> "98)_i68b5\Y/hK!2%QJ"L(mCTZ_ode,KL?mF9Ur"IhuYs8RT~> "98)aj351;]V54Q!2 at cP"L(gATZ_ode,KL?maoq$"I_oWs8RT~> "98)aj351;]9N2%!0tjC!jGU?JcF-t!qPd2e%GmQ8Yc=cJ,~> "98)_i68b5\Wco!!0b^>!jG[AJcF-t!qPa.e%,[O8YlCdJ,~> "98)aj351;]9N2%!0tjC!jGU?JcF-t!qPd2e%GmQ8Yc=cJ,~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)_i/kMOYZ5Oks3^iJo'OrU\ceKoV#UIF~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)_i/kMOYZ5Oks3^iJo'OrU\ceKoV#UIF~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)aj,gqUY\9,Lp!NF6m-WER]`acqU]:@E~> "98)_i/kMOY\K8Np!NF6m-W "98)aj,gqUY\9,Lp!NF6m-WER]`acqU]:@E~> "98)aj,gqT^<;)rcgLo,f at .D9RRs:Ss*t~> "98)_i/kMN]ZbrqcgLo+eC1u3Rn9FUs*t~> "98)aj,gqT^<;)rcgLo,f at .D9RRs:Ss*t~> "98)aj,gqT_9db\cd;d>`RDL'RRs:Ss*t~> "98)_i/kMM^4FSTc2l2,e%,[O8YlCdJ,~> "98)aj,gqT_9db\cd;d>`RDL'RRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj,gqS\Ug^)VuaTMe%GmQ8Yc=cJ,~> "98)_i/kMM[t1I&VZFEGe%,[O8YlCdJ,~> "98)aj,gqS\Ug^)VuaTMe%GmQ8Yc=cJ,~> "98)aj,gqTY[`5Hco_ABe(<'^"I_oWs8RT~> "98)_i/kMNY[i;JcohGEe'ujX"IhuYs8RT~> "98)aj,gqTY[`5Hco_ABe(<'^"I_oWs8RT~> "98)aj,gqUYYn)EXO4*N_ "98)_i/kMOYZ+5GXO4*N_X,e$\ceKoV#UIF~> "98)aj,gqUYYn)EXO4*N_ "98)aj3#%8[JmB2[(PA2!OKE,]`PE:D1V`7rrVcZf at .D9RRs:Ss*t~> "98)_i6&V2Zi7'-ZFSr*!O90'\cT*9D1V`7rrVcYeC1u3Rn9FUs*t~> "98)aj3#%8[JmB2[(PA2!OKE,]`PE:D1V`7rrVcZf at .D9RRs:Ss*t~> "98)aj3#%>;'e"S;OG,V]`C$`n%Ae,;f.*cdJj:=maoq$"I_oWs8RT~> "98)_i6&V8;C+(R:mSZO\cFg]n%&S) "98)aj3#%>;'e"S;OG,V]`C$`n%Ae,;f.*cdJj:=maoq$"I_oWs8RT~> "98)aj3#%>;2)]sH "98)_i6&V8;M2QlG[Iu?\cFg]n%&S) "98)aj3#%>;2)]sH "98)aj3#%_;2)]sH]5B2Ysp5X63Zn%Ae,;f.*cdJj:= maoq$"I_oWs8RT~> "98)_i6&VY;M2QlG[IXj5>el#GsJ.9O at t))GG:[G\n[k1;*TH1B2bso5 "98)aj3#%_;2)]sH]5B2Ysp5X63Zn%Ae,;f.*cdJj:= maoq$"I_oWs8RT~> "98)aj3#%_;&^f-;PLb!R"@hW@\->E?]\f4<0`;3\3bmGNhTup;hCB,U7s?6n%Ae,;f.*cdJj:= maoq$"I_oWs8RT~> "98)_i6&VY;B-u/:nY:mQ%;DR@@Ku@?B/T3 "98)aj3#%_;&^f-;PLb!R"@hW@\->E?]\f4<0`;3\3bmGNhTup;hCB,U7s?6n%Ae,;f.*cdJj:= maoq$"I_oWs8RT~> "98)aj3#%9;2+t^+e):^-o8PWD6pp6?_aMuGr'VL5_DLu]jtALPEeDH]f)MO]`PE:D1V`7rrVcZ f at .D9RRs:Ss*t~> "98)_i6&V3;M4qZ+dl1\-Si8PDR$d2 at A'GsGW'\M5Cu at r\n5/JOcr#@\iH;L\cT*9D1V`7rrVcY eC1u3Rn9FUs*t~> "98)aj3#%9;2+t^+e):^-o8PWD6pp6?_aMuGr'VL5_DLu]jtALPEeDH]f)MO]`PE:D1V`7rrVcZ f at .D9RRs:Ss*t~> "98)aj3#%9;2+t^+^oN,Si3%&F`*Y0M.;Qh?u2*4=Hu=J]jtALPEeDH]f)MO]`PE:D1V`7rrVcZ f at .D9RRs:Ss*t~> "98)_i6&V3;M4qZ+^fK)Rl6[uF`!P+LLZ "98)aj3#%9;2+t^+^oN,Si3%&F`*Y0M.;Qh?u2*4=Hu=J]jtALPEeDH]f)MO]`PE:D1V`7rrVcZ f at .D9RRs:Ss*t~> "98)aj3#%9;2+t^+d5nn2`%166[,8B7pr'`6F"+(FgZKf6X>[QPHJF`6Q)Nb]`PE:D1V`7rrVcZ f at .D9RRs:Ss*t~> "98)_i6&V3;M4qZ+d#ek2_q%16?Sr=7UVm]6Edq(GI)Nd6!oRPOfN"Y5oQ9^\cT*9D1V`7rrVcY eC1u3Rn9FUs*t~> "98)aj3#%9;2+t^+d5nn2`%166[,8B7pr'`6F"+(FgZKf6X>[QPHJF`6Q)Nb]`PE:D1V`7rrVcZ f at .D9RRs:Ss*t~> "98)aj3,+;\YQ>+[3E,mWh?#_]rds:]sFH:]st)S]reTR\"o\"\uiHTZCmka\F7*4YZ#Cis3^iJ o'Y,Y]`acqU]:@E~> "98)_i6/\5\"]o%Z6H]dW1BKU\uVC0]!.j/]!eNH\uW'H[%a+l\#ZmIYaq>W[I:[.YZ5Oks3^iJ o'OrU\ceKoV#UIF~> "98)aj3,+;\YQ>+[3E,mWh?#_]rds:]sFH:]st)S]reTR\"o\"\uiHTZCmka\F7*4YZ#Cis3^iJ o'Y,Y]`acqU]:@E~> "98)aj351;]6sN.!GK*j]`PE:D1V`7rrVcZf at .D9RRs:Ss*t~> "98)_i68b5\:"3+!GK$h\cT*9D1V`7rrVcYeC1u3Rn9FUs*t~> "98)aj351;]6sN.!GK*j]`PE:D1V`7rrVcZf at .D9RRs:Ss*t~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)_i/kMOYZ5Oks3^iJo'OrU\ceKoV#UIF~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)_i/kMOYZ5Oks3^iJo'OrU\ceKoV#UIF~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)_i/kMOYZ5Oks3^iJo'OrU\ceKoV#UIF~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)_i/kMOYZ5Oks3^iJo'OrU\ceKoV#UIF~> "98)aj,gqUYZ#Cis3^iJo'Y,Y]`acqU]:@E~> "98)aj,gqUY]$(`n^6k.lL!3P]`acqU]:@E~> "98)_i/kMOY]64bn^6k.lL!*M\ceKoV#UIF~> "98)aj,gqUY]$(`n^6k.lL!3P]`acqU]:@E~> "98)aj,gqT_:O8/cgh,1f at .D9RRs:Ss*t~> "98)_i/kMN^Xn&.cgq21eC1u3Rn9FUs*t~> "98)aj,gqT_:O8/cgh,1f at .D9RRs:Ss*t~> "98)aj,gqS^OaMPaT9K"e%GmQ8Yc=cJ,~> "98)_i/kMM]Re,K`rX2pe%,[O8YlCdJ,~> "98)aj,gqS^OaMPaT9K"e%GmQ8Yc=cJ,~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj351:\bN<.Zc%F.J\CHa"I_oWs8RT~> "98)_i68b4[eQp)Z,)"&J\(6["IhuYs8RT~> "98)aj351:\bN<.Zc%F.J\CHa"I_oWs8RT~> "98)aj351;VdK9i"&P6H^Oa(L^$`Q:RRs:Ss*t~> "98)_i68b5V.'3j"&bEH]RdYF]'d-4Rn9FUs*t~> "98)aj351;VdK9i"&P6H^Oa(L^$`Q:RRs:Ss*t~> "98)aj351=VEe+Gr0IMYch"pM]`Y!79o&&J!K`-:]`G-Of"D=!L6oTdQ at ZZb]a(*][CrYgR;Iqs "I_oWs8RT~> "98)_i68b7UdA%Gr0IMXcLALF\c\U09SMfD!K`'8\cJ^If")*pKU03[Q%6E^\d+[VZF[)^Qu.ho "IhuYs8RT~> "98)aj351=VEe+Gr0IMYch"pM]`Y!79o&&J!K`-:]`G-Of"D=!L6oTdQ at ZZb]a(*][CrYgR;Iqs "I_oWs8RT~> "98)aj351=VEg4?r;Qlsmdn3m]`kK=L6Z+rn%Ak4>GZ at Nrk/?@U"6m^[U=Ns]s"BI_S$20>d(i7 9q7mT]`OC:Z';p)RRs:Ss*t~> "98)_i68b7UdC.?r;Qlrm-q[e\co*9KTfhpn%&Y.>,64Lrji-:T at URXZX8-l\uhgF\d*ppXh(0" S"BSi!g7N*Pe%!e8YlCdJ,~> "98)aj351=VEg4?r;Qlsmdn3m]`kK=L6Z+rn%Ak4>GZ at Nrk/?@U"6m^[U=Ns]s"BI_S$20>d(i7 9q7mT]`OC:Z';p)RRs:Ss*t~> "98)aj351=VEg4?r;Qlsmdn3m]bIA8UV4=Q]ssW%X1b=<]s"NJV4+.X]a_;/N,<('Th0];V at 0[AU^9[C3'FXI>ch[[X;0URH(&YJ$W(SYWru S%"2LS "98)_i68b7UdC.?r;Qlrm-q[e\eLu5TXq\E]![uoWOeh2\ui!@UR7\Q\dbo*Mf*"$S[#Ps\u(n' rjmBQR$aGU\u1pc[CWH/Xh(m.V7NG.ZDb74XL4[fUq3 at k['-!_;16$eYGe;%SYER(]!\BBYG\t+ R%^pgX1G^5YaDH%]!@loR]X0/R@'tb\"0;&\>>b&Z_Y1.ZEpI;WgK?_Z^@]&TpTY!Xh(0"S"dKl R'h`GRZtAdRn9FUs*t~> "98)aj351=VEg4?r;Qlsmdn3m]bIA8UV4=Q]ssW%X1b=<]s"NJV4+.X]a_;/N,<('Th0];V at 0[AU^9[C3'FXI>ch[[X;0URH(&YJ$W(SYWru S%"2LS "98)aj351=VEg4?r;Qlsmdn3m]bdn_DfqM^]rOq!>G*dA]lIJ=<(KoH]tJp%.pldP=%m\!31O)A G-JZm<%^^8MS4 at .:4J[C95C&B8QVBDR#tLM?Y4md86D6H6'uRa750/']6dXN<)6MO\@nP*UOlI. '9s;5 "98)_i68b7UdC.?r;Qlrm-q[e\ehJYD0))U\u8 at o>bggVbBQcTm][9Mih(7FH&Z!7$3^4LgikKFH.5eN`8M(:9D)8TM9tr RT`4*I55fQQ+@*f8YlCdJ,~> "98)aj351=VEg4?r;Qlsmdn3m]bdn_DfqM^]rOq!>G*dA]lIJ=<(KoH]tJp%.pldP=%m\!31O)A G-JZm<%^^8MS4 at .:4J[C95C&B8QVBDR#tLM?Y4md86D6H6'uRa750/']6dXN<)6MO\@nP*UOlI. '9s;5 "98)aj351=VEg4?r;Qlsmdn3l]kXQlD.&L>XB/1DFa.VWB8TYG:d@:Z]sC"rE^6+e7YEah=e15L ]t at Zr]pq'qJ5J`sKk6"'R<*/7QTU4=?%6*\;3eb<>="C9;5Ud0ID*7>=@cDqL0_$sTLYc/<)&4_ LK at Pi]q@?>:&_g^NEWBe?&#C[:F1=4CQb!DAWDY+6A8lPJPfKU]qS#M4M=7?]n]jr]qJ/N1mhI: KR@%-Pe at 3g8Yc=cJ,~> "98)_i68b7UdC.?r;Qlrm-q[d\n\-dCLN=9WDu\?GBdkYAr0GD:Hq(T]!4PmF$Q1d8V9'i>+:2I ]")0l\t(glIS`EpKk?%&QZHo1PWk";?@H3a;j=e9?9sX9<2?j-ICct:=\)PpKO(alT1Yf,;bi+Z LK[kq\t1s::B%g\N*<3`?%f1U:*k72ClssAA;l;&6A8lRJl>i^\tDWI5IsFC\qOFl\tDcK2j[a; K7$q)Pe%!e8YlCdJ,~> "98)aj351=VEg4?r;Qlsmdn3l]kXQlD.&L>XB/1DFa.VWB8TYG:d@:Z]sC"rE^6+e7YEah=e15L ]t at Zr]pq'qJ5J`sKk6"'R<*/7QTU4=?%6*\;3eb<>="C9;5Ud0ID*7>=@cDqL0_$sTLYc/<)&4_ LK at Pi]q@?>:&_g^NEWBe?&#C[:F1=4CQb!DAWDY+6A8lPJPfKU]qS#M4M=7?]n]jr]qJ/N1mhI: KR@%-Pe at 3g8Yc=cJ,~> "98)aj351=VEg4?r;Qlsmdn3i]k:YjVH8_<7!5P!@pc?B@?QhJ]tLa'rtL/%Z\1Q>S=Y[)*GNfZYU[t/4p]9Z]mO[32r1NH>o?bN1(KKQq "98)_i68b7UdC.?r;Qlrm-q[a\n>GkV,iJ77X(h$A6u9>@ZZ\C]"5.4So\DQT1OYs\tM]k]"5FZ GIj>'Ht&+a7\H\hKY"L5 at _+dV8Rc%3>#UZqG@!RrP>n?a?[]MrHs'!u\qF at l\t;TgIoB*t\qaHm BtBlsKhhWY1Q5M:Y$GmEN/pDS[=Dqk\ "98)aj351=VEg4?r;Qlsmdn3i]k:YjVH8_<7!5P!@pc?B@?QhJ]tLa'rtL/%Z\1Q>S=Y[)*GNfZYU[t/4p]9Z]mO[32r1NH>o?bN1(KKQq "98)aj351=VEg4?r;Qlsmdn3m]ka]ON1F=(Uf*JI8ThV.1jP[JW1R%$Zo:PNk,Ch\Z(YBX6]X[J_,?_**SLHN7SGb&eUYJ$W(J2;C^ QV2X4TTm+mRRs:Ss*t~> "98)_i68b7UdC.?r;Qlrm-q[e\ne9IMOS%&UJ[5D96[n-=/3- "98)aj351=VEg4?r;Qlsmdn3m]ka]ON1F=(Uf*JI8ThV.1jP[JW1R%$Zo:PNk,Ch\Z(YBX6]X[J_,?_**SLHN7SGb&eUYJ$W(J2;C^ QV2X4TTm+mRRs:Ss*t~> "98)aj351=Vdun!r::$\lLVdh]b@&>7>&:eW_GoNOM%B:YJ%,T7:6#,7&G9[KtXL,R;'?W8?';9 ]MpFNt/hIE1st3;FOHI]tBPWF.L"5J at 3)(Si?Y^$>2e= XM&jWLhN6#rk1.J0gABm]rF[n7?XlVCTt9i "98)_i68b7V.Qh!r::$[l0u at a\eCZ77"Mq\W(TNHO1Cs2Xh(WL6sfi'7&5*XK=\%&QYF$R8>s,2 \Q14Kke77:UbM,')BVb2!@\nJ"QM1iI>>X`SBDP+M+;FF?F]"+#PEh'_.J$QYsS2UAX$>)\9 Wk*=OLM<-!rjjqF0g89j\u/+f7$4WRCTb$b "98)aj351=Vdun!r::$\lLVdh]b@&>7>&:eW_GoNOM%B:YJ%,T7:6#,7&G9[KtXL,R;'?W8?';9 ]MpFNt/hIE1st3;FOHI]tBPWF.L"5J at 3)(Si?Y^$>2e= XM&jWLhN6#rk1.J0gABm]rF[n7?XlVCTt9i "98)aj351;^t8DP!qZ-#rk/;ErDN`(SD_'^]O#j2]`YTb<-@]D!f^BaJ\C*W"I_oWs8RT~> "98)_i68b5^=W2Ns766'rji)@rD "98)aj351;^t8DP!qZ-#rk/;ErDN`(SD_'^]O#j2]`YTb<-@]D!f^BaJ\C*W"I_oWs8RT~> "98)aj351:_Y;:UbJ*th!1<_H!L9kG]`G"4d_,anT9ctU]`PI8\UhHS]`acqU]:@E~> "98)_i68b4^\>nPaLhG_!1*SC!L'VB\cJV,d^fOhSWpMN\cT(1[Xl$M\ceKoV#UIF~> "98)aj351:_Y;:UbJ*th!1<_H!L9kG]`G"4d_,anT9ctU]`PI8\UhHS]`acqU]:@E~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4nc]`P*#.)de?-kT>G]`HaX`:a8cDj'q0"I_oWs8RT~> "98)_i.8J]\cS]r-cIY=-kT;F\cL=R`:a8cDia_*"IhuYs8RT~> "98)aj+4nc]`P*#.)de?-kT>G]`HaX`:a8cDj'q0"I_oWs8RT~> "98)aj+4nc]`Y-:c1T-L"7NW,8asCpg$RD2df\!Z6B:lT"I_oWs8RT~> "98)_i.8J]\cSX3cGoMZn$``sn at A\Om+B>,"4<5sN;:$fRn9FUs*t~> "98)aj+4nc]`Y-:c1T-L"7NW,8asCpg$RD2df\!Z6B:lT"I_oWs8RT~> "98)aj+4nc]`Y-:akFe["2/[[8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)_i.8J]\c\^4b1an["28g^8FX1lea(At\c]I!6&bWN"IhuYs8RT~> "98)aj+4nc]`Y-:akFe["2/[[8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)_i.8J]\c\^4b14PD"0ZYL8FX1lea(At\c]I!6&bWN"IhuYs8RT~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)aj+4nc]`Y-:ajfRg!4Mm*#J.UVZb "98)_i.8J]\c\^4b15af$aZ\+VRO.BYe% "98)aj+4nc]`Y-:ajfRg!4Mm*#J.UVZb "98)aj+4nc]`Y-:ajfUh%'aG,4$A/$FCMb<@'&\-"0cYK8asCpg$HlP]a)3E=?AT "98)_i.8J]\c\^4b15dg%'F;*3]qnsFCDS7@&`J'"0ZYL8FX1lea(BK\d,d>=Z\Z "98)aj+4nc]`Y-:ajfUh%'aG,4$A/$FCMb<@'&\-"0cYK8asCpg$HlP]a)3E=?AT "98)aj+4nc]`Y-:ajfUh$^a&i]s^.rFC9c;V "98)_i.8J]\c\^4b15dg$^O#g]!FVlFC0Z8U[#DmYAab "98)aj+4nc]`Y-:ajfUh$^a&i]s^.rFC9c;V "98)aj+4nc]`Y-:ajfUh$CErh]s^.rF=1_#l+I2'D?ri']`QmRb4<4J\n>]frOiqd3)$3 "98)_i.8J]\c\^4b15dg$C3of]!FVlF=1b"l+-u#E!T#(\cUFJb4<+G\7fTdrON__2bKm5CihY2 \rB'@LUs "98)aj+4nc]`Y-:ajfUh$CErh]s^.rF=1_#l+I2'D?ri']`QmRb4<4J\n>]frOiqd3)$3 "98)aj+4nc]`Y-:ajfUh$CErh]s^.rF;JZ"l+I2'D?ri']`QmRb4<4J\n>]frOirER".DU%rJ:4 G?gW3Blch,Q;;ogS+F;q]8&_5q7Qp"8Yc=cJ,~> "98)_i.8J]\c\^4b15dg$C3of]!FVlF;J`"l+-u#E!T#(\cUFJb4<+G\7fTdrON`?Q%2/R%r8%. F^(9,Blln+PYllhSFa;o\; "98)aj+4nc]`Y-:ajfUh$CErh]s^.rF;JZ"l+I2'D?ri']`QmRb4<4J\n>]frOirER".DU%rJ:4 G?gW3Blch,Q;;ogS+F;q]8&_5q7Qp"8Yc=cJ,~> "98)aj+4nc]`Y-:ajfUh$^a&i]s^.rFC962Y3N\&Y\j_ "98)_i.8J]\c\^4b15dg$^O#g]!FVlFC000XQmA!YAab "98)aj+4nc]`Y-:ajfUh$^a&i]s^.rFC962Y3N\&Y\j_ "98)aj+4nc]`Y-:ajfUh%%'/j]s^.rFCMV*D6`E?"0cYK8asCpg$HlP]cF[sBY(mQNF?Y:S2c9r ]tHCD=fSrkJjQcUMjcYqo=Y7 "98)_i.8J]\c\^4b15dg%$j,h]!FVlFCDJ'Cp**8"0ZYL8FX1lea(BK\fJ:oBt1aKMdpM5S2u?s ]"0h;=/WHcJjHTNMjZSqo=>%6M*[*r\ceKoV#UIF~> "98)aj+4nc]`Y-:ajfUh%%'/j]s^.rFCMV*D6`E?"0cYK8asCpg$HlP]cF[sBY(mQNF?Y:S2c9r ]tHCD=fSrkJjQcUMjcYqo=Y7 "98)aj+4nc]`Y-:ajfUh%'aG,4$A/$FCMqjKj!`T"0cYK8asCpg$HlP]cFb[=?ATbsKNo=Y7 "98)_i.8J]\c\^4b15dg%'F;*3]qnsFCDbdKNIKN"0ZYL8FX1lea(BK\fJ>T=Z\Z%6M*[*r\ceKoV#UIF~> "98)aj+4nc]`Y-:ajfUh%'aG,4$A/$FCMqjKj!`T"0cYK8asCpg$HlP]cFb[=?ATbsKNo=Y7 "98)aj+4nc]`Y-:ajfRg!4Mm*#J.UVZb=&`Y3Wb'Y\j_\b!K:]8&_5q7Qp"8Yc=cJ,~> "98)_i.8J]\c\^4b15af$aZ\+VRO.BYe%ETX6[>!YAab "98)aj+4nc]`Y-:ajfRg!4Mm*#J.UVZb=&`Y3Wb'Y\j_\b!K:]8&_5q7Qp"8Yc=cJ,~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)_i.8J]\c\^4b14PD"0ZYL8FX1lea(At\c]I!6&bWN"IhuYs8RT~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)_i.8J]\c\^4b14PD"0ZYL8FX1lea(At\c]I!6&bWN"IhuYs8RT~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)_i.8J]\c\^4b14PD"0ZYL8FX1lea(At\c]I!6&bWN"IhuYs8RT~> "98)aj+4nc]`Y-:ajeAE"0cYK8asCpg$Hl$]`Ym%6B:lT"I_oWs8RT~> "98)aj+4nc]`Y-7Z@']7"*7ZP8asCpg$-Do\-'0n6B:lT"I_oWs8RT~> "98)_i.8J]\c\^2Y^XW9"*@iT8FX1le`ark[0*dj6&bWN"IhuYs8RT~> "98)aj+4nc]`Y-7Z@']7"*7ZP8asCpg$-Do\-'0n6B:lT"I_oWs8RT~> "98)aj+4nc]`Fuh_Z0]=8aj=mNl4lu9fJ+.]`acqU]:@E~> "98)_i.8J]\cJQa_Z0]=8FX1k]8X[/!_t\5q76]u8YlCdJ,~> "98)aj+4nc]`Fuh_Z0]=8aj=mNl4lu9fJ+.]`acqU]:@E~> "98)aj+4nc]`GB\_cQqBJ+1,PP[21/!G8/']`acqU]:@E~> "98)_i.8J]\cJsU_c?e?IIOfKP?c"+!G%o"\ceKoV#UIF~> "98)aj+4nc]`GB\_cQqBJ+1,PP[21/!G8/']`acqU]:@E~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)_i.8Ij\u`IGRn9FUs*t~> "98)aj+4mp]r\mMRRs:Ss*t~> "98)K\UgB(T<+XfMFjTCs*t~> "98)K\:L6&SueLdMb0`Es*t~> "98)K\UgB(T<+XfMFjTCs*t~> "96eU0nCp-/ZUH*.AQqCJ,~> "96hW14_'//upT,.]!+EJ,~> "96eU0nCp-/ZUH*.AQqCJ,~> !rqi?J^&bjWm(XnmJm3:~> !rqi at J^&bjWm(XnmJm3:~> !rqi?J^&bjWm(XnmJm3:~> %%EndData showpage %%Trailer end %%EOF --- fedora-proxy-guide-en.xml DELETED --- From fedora-docs-commits at redhat.com Fri Jun 24 21:00:20 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Fri, 24 Jun 2005 17:00:20 -0400 Subject: proxy-guide Makefile,1.2,1.3 Message-ID: <200506242100.j5OL0Ksa014395@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/proxy-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14378 Modified Files: Makefile Log Message: Update Makefile to address new resource locations Index: Makefile =================================================================== RCS file: /cvs/docs/proxy-guide/Makefile,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Makefile 24 Jun 2005 20:39:40 -0000 1.2 +++ Makefile 24 Jun 2005 21:00:18 -0000 1.3 @@ -7,18 +7,18 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en -DOCNAME = fedora-proxy-guide-$(LANG) +DOCNAME = proxy-guide-$(LANG) XMLFILE = $(DOCNAME).xml ###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: From fedora-docs-commits at redhat.com Fri Jun 24 21:02:58 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Fri, 24 Jun 2005 17:02:58 -0400 Subject: proxy-guide proxy-guide-en.xml,1.2,1.3 Message-ID: <200506242102.j5OL2wvE015428@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/proxy-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv15414 Modified Files: proxy-guide-en.xml Log Message: Updated entities to address new resource locations, removed redundancy Index: proxy-guide-en.xml =================================================================== RCS file: /cvs/docs/proxy-guide/proxy-guide-en.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- proxy-guide-en.xml 24 Jun 2005 20:39:40 -0000 1.2 +++ proxy-guide-en.xml 24 Jun 2005 21:02:32 -0000 1.3 @@ -1,7 +1,7 @@ + %FEDORA-ENTITIES-EN; @@ -12,8 +12,6 @@ - - ]>
From fedora-docs-commits at redhat.com Mon Jun 27 17:30:37 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Mon, 27 Jun 2005 13:30:37 -0400 Subject: xml-normalize 010-text.xml,1.3,1.4 Message-ID: <200506271730.j5RHUbaB011640@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv11619 Modified Files: 010-text.xml Log Message: Going right. Index: 010-text.xml =================================================================== RCS file: /cvs/docs/xml-normalize/010-text.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- 010-text.xml 21 Jun 2005 23:54:24 -0000 1.3 +++ 010-text.xml 27 Jun 2005 17:30:34 -0000 1.4 @@ -1,120 +1,126 @@ - - - - - - - -]> - - -Linux Device Drivers - - -LDD - - - -MegaCoder Logo - - -Tommy -Reynolds -
-P O Box 62 -Danville -Alabama -35619 -
-Tommy.Reynolds at MegaCoder.com - - -2004 - -Tommy Reynolds - - - - -Initial -07 Sep 2004 -JTR - -Initial release. - - - - - - - -Although the information in this document has been carefully reviewed, no representations or warranties, either expressed or implied, are made concerning the contents itself nor the application thereof. -Any expressed or implied warranties of merchantability or fitness of purpose are expressly disclaimed. - - - -No part of this publication may be reproduced, photocopied, stored on a retrieval system, or transmitted with the express prior written consent of the publisher. -Neither this manual, nor any portion thereof, may be copied in any form without the express written permission of MegaCoder.com. - - - -MegaCoder.com reserves the right to revise this publication and to make changes in its content at any time for any reason whatever, without obligation to notify any person or entity of such revisions or changes. - - - -This MegaCoder.com document is published solely to instruct students in the use of Linux software. -Although third-party application software packages may be used as part of this activity, their use is solely for demonstration purposes only and their use shall neither constitute nor be construded as an endorsement. - - - -Some of the software included in the presentation of this course or accompanying the student kit may be proprietary and therefore not be freely redistributable. -Throughout the world the unauthorised duplication of copyrighted or proprietary software is subject to both criminal and civil penalties. -If there are any questions about which part or parts of the student kit are proprietary and hence not freely redistributable, contact MegaCoder.com at +1.256.350.5099 for clarification. - - -Linux is a registered trademark of Linus Torvalds. - - - -Red Hat and the shadowman logo are trademarks of Red Hat, Inc. - - - -Motif and UNIX are registered trademarks of The Open Group. - - - -Intel and Pentium are registered trademarks of Intel Corporation. Itanium -and Celeron are trademarks of Intel Corporation. - - - -AMD, AMD Athlon, AMD Duron, and AMD K6 are trademarks of Advanced Micro -Devices, Inc. - - - -Windows is a registered trademark of Microsoft Corporation. - - - -SSH and Secure Shell are trademarks of SSH Communications Security, Inc. - + -FireWire is a trademark of Apple Computer Corporation. - + + + + + + - -All other trademarks and copyrights referred to are the property of their -respective owners. - + ]> - + + Linux Device Drivers + LDD + + + + + + MegaCoder Logo + + + + Tommy + Reynolds +
+ P O Box 62 + Danville + Alabama + 35619 +
+ Tommy.Reynolds at MegaCoder.com + + + 2004 + Tommy Reynolds + + + + Initial + 07 Sep 2004 + JTR + + Initial release. + + + + + + Although the information in this document has been + carefully reviewed, no representations or warranties, either + expressed or implied, are made concerning the contents itself nor + the application thereof. Any expressed or implied warranties of + merchantability or fitness of purpose are expressly + disclaimed. + + + No part of this publication may be reproduced, photocopied, stored + on a retrieval system, or transmitted with the express prior + written consent of the publisher. Neither this manual, nor any + portion thereof, may be copied in any form without the express + written permission of MegaCoder.com. + + + MegaCoder.com reserves the right to revise this publication and to + make changes in its content at any time for any reason whatever, + without obligation to notify any person or entity of such + revisions or changes. + + + This MegaCoder.com document is published solely to instruct + students in the use of Linux software. Although third-party + application software packages may be used as part of this + activity, their use is solely for demonstration purposes only and + their use shall neither constitute nor be construded as an + endorsement. + + + Some of the software included in the presentation of this course + or accompanying the student kit may be proprietary and therefore + not be freely redistributable. Throughout the world the + unauthorised duplication of copyrighted or proprietary software is + subject to both criminal and civil penalties. If there are any + questions about which part or parts of the student kit are + proprietary and hence not freely redistributable, contact + MegaCoder.com at +1.256.350.5099 for clarification. + + + Linux is a registered trademark of Linus Torvalds. + + + Red Hat and the shadowman logo are + trademarks of Red Hat, Inc. + + + Motif and UNIX are registered trademarks of The Open Group. + + + Intel and Pentium are registered trademarks of Intel Corporation. + Itanium and Celeron are trademarks of Intel Corporation. + + + AMD, AMD Athlon, AMD Duron, and AMD K6 are trademarks of Advanced + Micro Devices, Inc. + + + Windows is a registered trademark of Microsoft Corporation. + + + SSH and Secure Shell are trademarks of SSH Communications + Security, Inc. + + + FireWire is a trademark of Apple Computer Corporation. + + + All other trademarks and copyrights referred to are the property + of their respective owners. + + + From fedora-docs-commits at redhat.com Mon Jun 27 18:33:37 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Mon, 27 Jun 2005 14:33:37 -0400 Subject: xml-normalize yum-software-management-en.xml,NONE,1.1 Message-ID: <200506271833.j5RIXbfj013087@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13067 Added Files: yum-software-management-en.xml Log Message: Using xmlformat in tidy-bowl, testing commences... --- NEW FILE yum-software-management-en.xml --- %FEDORA-ENTITIES-EN; ]>
Software Management with <command>yum</command> 2005 Stuart Ellis Ellis Stuart &LEGALNOTICE; 0.4 2005-06-01 StuartEllis Initial import into CVS.
Introduction &DRAFTNOTICE;
Audience The yum utility is currently the recommended method for managing software on &FED; systems. All &FED; users responsible for maintaining their own systems will find yum an essential tool.
Using This Document This document is a reference for using yum. You may wish to read some or all of the sections, depending upon your needs and level of experience. If you are a new user, read the before using yum for the first time. Experienced Linux users should start with . Anyone with several &FED; systems on a network may benefit from setting up their own software repositories to manage the process of installation and updates. The details of maintaining your own repositories are explained in . Most of the examples use the package tsclient, which is included with &FC; to provide an application for remote desktop access. If it is installed successfully you may start the application by choosing ApplicationsInternetTerminal Server Client. To use the examples, substitute the name of the relevant package for tsclient. Avoid Logging in with the Root Account You do not need to log in with the root account in order to manage your &FC; system. All of the commands shown in this tutorial that require root access will prompt you for the root password. The example terminal commands use su to provide this facility.
Additional Resources The yum utility has features and options that are not discussed in this document. Read the man pages for yum(8) and yum.conf(5) to learn more. The official Website for yum is: http://linux.duke.edu/projects/yum/ The official mailing list for yum users is: https://lists.dulug.duke.edu/mailman/listinfo/yum The archive for the yum development mailing list is here: https://lists.dulug.duke.edu/pipermail/yum-devel/
Software Management Concepts
About Packages All of the software and documentation prepared for use with &FED; is supplied in the form of files called RPM packages defined packages. Each package is a compressed archive containing product information, program files, icons, documentation and management scripts. Packages also include a digital signature to prove their source. These files are used by management applications to safely locate, install, update and remove software. For example, the &FED; installation process uses the packages supplied with &FC; to build or upgrade a system to your requirements.
About Repositories Software management utilities like yum are not intended to enable you to install a specific package file. Instead, they automatically locate and obtain the correct RPM packages for an application from repositories defined repositories, which are prepared directories or Websites. The package management utilities in &FC; are automatically configured to use the network of repository servers maintained by the &FP;. These repositories hold both the software included with &FC;, and a large selection of additional software, known as &FEX;. Third-party software developers also provide repositories for their &FED; compatible packages. This method frees you from having to manually find and install new applications or updates: you may use a single command to update all of the software that makes up your system, or to search for new software by specifying criteria. In each case the management utility connects to the repositories that it is configured to use, and checks the indexes that they provide to find the correct packages. Using repositories also ensures also that you always receive the current version of the software. If several versions of the same package are available then your management utility automatically selects the latest version. For these reasons you should only manually install software when you are confident that there is no repository that can currently provide it. If a piece of software on your system is not available from a repository then no update feature can automatically find or install newer versions, and you must keep that product updated yourself. All &FED; Packages are Free Software All of the software provided by the &FP; is Free Software, or Open Source, and can therefore be downloaded and installed from the network of &FED; repositories without restrictions.
About Dependencies You must consider package dependencies dependencies when manually installing software. To avoid conflicts and inconsistencies Linux distributions supply program library files as separate packages to the applications that use their functions. Many libraries and command-line utilities are used by multiple applications. Management tools like yum use the information on dependencies stored within packages to ensure that all of the requirements are met when you install an application. The packages for any supporting software are automatically be installed first, if they are not already present on your system. If a new application has requirements that conflict with existing software then the installation process safely aborts without making any changes to your system.
Understanding Package Names Each package file has a long name that indicates several key pieces of information. For example, this is the full name of a package supplied with &FC;: tsclient-0.132-4.i386.rpm Use just the name of the package itself with yum, except when it is necessary to specify the exact version or type. To specify the exact version of the application, use name-version. The package listings provided by yum itself use the format name.architecture, to specify the type of computer that the package is intended for. These are valid for the file shown above: Package name: tsclient Package name with version number: tsclient-0.132 Package name with hardware architecture: tsclient.i386 The hardware architecture is the minimum type of machine required for that specific package. Packages with run on any current Intel-compatible computer. Packages for PowerPC machines, such as Apple Macs, are indicated with . Packages with have no architecture requirement. Some software can be optimized for particular types of Intel-compatible machine, and separate packages are provided for , , and . A computer with at least an Intel Pentium, VIA C3 or compatible chip is an . Computers with an Intel Pentium II and above, or a current model of AMD chip, are machines. 64-bit PCs use packages for full 64-bit support. Other Naming Conventions are Supported Refer to for more information on specifying packages by name or type.
Software Management Tools in &FC; The yum utility is a complete software management system. &FC; also includes other several other applications that can supplement yum. On your desktop is an up2date alert icon alert icon that keeps you informed about package updates. Until your system is updated this appears as a red circle with a flashing exclamation mark. The alert icon is integrated with up2date up2date, which enables you to easily install updates for your system. Both up2date and yum are configured to use official &FED; repositories. If you add other repositories to yum then for consistency you should also configure up2date to use them. Also included in &FC; is system-config-packages Add/Remove Applications system-config-packages system-config-packages. From the main menu, this is System SettingsAdd/Remove Applications. Unlike up2date and yum, it installs software packages from your &FC; installation discs, and does not use repositories. You may find this application useful for systems that do not have a network connection. The rpm command-line utility has many functions for working with individual RPM packages, and can also be used to manually install and remove packages from your system. Installing software with the rpm utility can be difficult, and is not recommended. Current Package Versions Using up2date and yum ensures that you have the most recent version of the packages that are being installed. Other methods do not guarantee that the packages are current.
Authorizing Package Sources All of the packages that you install should be digitally signed to prove their source. By default, yum does not install packages unless their digital signature matches a GPG public key on the rpm keyring. No keys are automatically included on the keyring. You must manually GPG public keys adding add the public key for &FP; packages, which is the file /usr/share/rhn/RPM-GPG-KEY-fedora. To import this public key, type the following: su -c 'rpm --import /usr/share/rhn/RPM-GPG-KEY-fedora' Enter the root password when prompted. Other public keys can be added in the same way. You can also import public keys directly from a Website. For example, to import the file GPG-PUB-KEY.asc on the website www.therepository.com the command would be: su -c 'rpm --import http://www.therepository.com/GPG-PUB-KEY.asc' Public Keys and <application>up2date</application> The up2date utility automatically uses the public key for &FC; packages. It does not add the public key to the keyring that is used by both yum and the rpm utility.
Updating Your System with <command>yum</command> You may update all of the software that makes up your &FC; system in a single operation. This is done with the function. To carry out a full system update, type this command in a terminal window: su -c 'yum update' Enter the root password when prompted. Data files are downloaded from each of the repositories that yum is configured to use. These index and header files are searched for information about newer versions of packages. On a slow connection the download process may take several seconds. A list of all of the available updates for your system is displayed. Press y to accept the updates. If you accept the updates the relevant packages are then downloaded and installed.
Automatically Updating Your System If your system is permanently connected to the network then updates can be performed at any time. The yum package includes scripts that can automatically carry out full updates every day. To activate automatic daily updating, type this line: su -c '/sbin/chkconfig --level 345 yum on; /sbin/service yum start' Enter the root password when prompted. How Daily Updates are Run There is no separate yum service that runs on your system. The command given above enables the control script /etc/rc.d/init.d/yum. This control script activates the script /etc/cron.daily/yum.cron, so that the cron service will perform the system update as one of the tasks that are automatically run each day.
Searching for Software with <command>yum</command> You may use yum to find software that is available from the defined repositories, or is already installed on your system. Searches automatically include both installed and available packages. Searches are not Case-sensitive The and options of yum are not case-sensitive. For example, a query for palmpilot will automatically find PalmPilot packages.
Searching by Package Name and Attributes To search for a specific package by name, use the function. For example, to search for the package tsclient the command would be: yum list tsclient To make your queries more specific, add other package attributes. For example, to search for version 0.132 of the application the command would be: yum list tsclient-0.132 Package Attributes You may use any of the following formats for specifying a package in a yum query: name, name.architecture, name-version, name-version-release, name-version-release.architecture, and epoch:name-version-release.architecture.
Advanced Searches If you do not know the name of the package, use either the or options. checks the names, descriptions, summaries and listed package maintainers of all of the available packages to find those that match. For example, to search for all packages that relate to PalmPilots, type: yum search PalmPilot The function checks both the files included in the packages and the functions that the software provides. This option requires yum to download and read much larger index files than other types of search. To search for all packages that include files called libneon you type: yum provides libneon To search for all packages that either provide an MTA (Mail Transport Agent) service, or include files with mta in their name: yum provides MTA Wildcards and Regular Expressions You may use the standard wildcard characters in search criteria: to represent any one character, and to mean any characters. Use Perl or Python regular expressions to carry out more complex queries.
Understanding Matches When carrying out a search yum shows all of the packages that match your criteria. Packages must meet the terms of the search exactly to be considered matches, unless you have used wildcards or a regular expression. For example, querying for shadowutils or shadow-util would not produce the package shadow-utils. This package would match and be shown if the query was either shadow-util? or Shadow*. When several versions of the same package are available, only the newest is used.
Managing Software Packages with <command>yum</command> yum, package management The yum utility has three basic management functions: new software packages. existing software. unwanted software. In each case you must specify the function and the criteria. Some simple examples are given in each section. Search Criteria See for details of search criteria. The management options of yum are case-sensitive. As with the search and system update functions, yum begins the process by downloading data files from each of the repositories that it is configured to use. Once yum has determined the steps to carry out the task you are presented with the proposed package changes, which you can either approve or reject. By default no changes are made to your system unless you approve. Downloaded Packages The RPM packages downloaded and used by yum are held in sub-directories of /var/cache/yum/, with one sub-directory per repository. You may copy these cached packages and use them elsewhere if you wish. Removing a package from your system does not delete the downloaded RPM from the cache. See for details on purging the caches.
Installing a New Software Package with <command>yum</command> installing software with yum packages, installing To install or update software, yum examines the package caches on your system and each of the configured package sources to determine the best set of actions to produce the required result. This may include installing or updating other packages in addition to the package that you specified. To install the package tsclient, enter the command: su -c 'yum install tsclient' Enter the root password when prompted.
Updating a Software Package with <command>yum</command> updating software with yum packages, updating Updating a software package follows the same process as installing a new package. For example, to update the tsclient package to the latest version, type: su -c 'yum update tsclient' Enter the root password when prompted.
Removing Software with <command>yum</command> removing software with yum packages, removing To remove software, yum examines your system for both the specified software, and any other software that must also be removed in order to safely uninstall it. To remove the tsclient package from your system the full command is: su -c 'yum remove tsclient' Enter the root password when prompted.
Using Other Software Repositories &FEX; repositories, finding searching for repositories Projects and individuals that provide RPM packages through yum repositories will provide details on their Website. The &FEX; project is the official source for additional packages. The Website for &FEX; is here: http://fedora.redhat.com/projects/extras/ Repositories for Early Versions of &FC; &FEX; does not provides packages for &FC; 2 or earlier. The official Website for additional packages for &FC; 1 and &FC; 2 is: http://www.fedora.us/ You should use these sites for software that is not included with &FC;. If these sites do not provide packages for a specific piece of software, the manufacturer of the software may provide or recommend a repository.
Adding a Repository as a Package Source repositories, adding to yum repository definition files, installing &FC; includes a yum package that has &FED; repositories in the configuration. To add an extra repository, place a definition file in the /etc/yum.repos.d/ directory on your system. Package providers make the definition files for their repositories available on their Websites. Definition File Extension The names of repository definition files end with .repo. Adding a file to the definitions directory requires root access. To copy the definition file example.repo, type the command: su -c 'cp example.repo /etc/yum.repos.d/' Enter the root password when prompted. You must also add the public key of the package provider, if you have not not already imported it. The process is described in . Repositories and <application>Up2date</application> Channels You should also add new package repositories as up2date channels to ensure consistency between the behavior of the two applications.
Understanding Repository Compatibility packages, software compatibility repositories, compatibility The &FEX; project provides packages that are built to the same standards as the packages that are part of &FC;. Third-party packages should be compatible with these official packages, unless the provider specifically states otherwise. You should still always check the Website of the provider for compatibility information before attempting to use a repository. Repositories often provide packages that are specifically intended for use with packages that are supplied by other repositories. In some cases separate third-party repository providers may each offer different versions of the same software, preventing those repositories from being safely used together by your &FC; system. Packages that have been made for one version of &FC; are usually not compatible with other versions of &FC;. The Website of the provider should specifically state which versions of &FC; they support. Old Versions of <command>yum</command> and Current Repositories The data format for repository indexes changed with version 2.11 of yum. This was the version supplied with &FC; 3. Repository providers should specify the versions of &FC; that they support. All repositories compatible with current versions of yum can also be identified by the fact that they have a sub-directory called repo-data/.
Maintaining <command>yum</command> The yum system does not require any routine maintenance. It is useful to disable or remove repository definitions that are no longer required, as each repository that is defined and enabled is checked for every operation. You may also wish to periodically remove files relating to unwanted packages, in order to save disk space.
Disabling or Removing Package Sources repositories, disabling in yum repositories, removing from yum repository definition files, removing Set enable=0 in a definition file to prevent yum using that repository. Any definition file with this setting is ignored. To completely remove access to a repository: Delete the relevant file from /etc/yum.repos.d/. Delete the cache directory from /var/cache/yum/. public keys, removing If you will not be using any more packages from that source then you should also remove their public key from the rpm keyring. To remove a public key you first need to know the identification name used by rpm. You may view the details of all public keys with the command: rpm -qi gpg-pubkey-* The identification name for a key is . For example, the &FP; public key is currently version 4f2a6fd2, release 3f9d9d3b. The rpm identification for this key is . Once you know the identification name of the key, use the command rpm to remove it. To remove the &FP; public key shown above the exact command would be: su -c 'rpm -e gpg-pubkey-4f2a6fd2-3f9d9d3b' Enter the root password when prompted.
Clearing the <command>yum</command> Caches yum, cleaning caches By design, yum does not automatically delete any of the packages or package header files that it downloads, so that these can be reused. Header files accumulate over time, and these may be purged with the command: su -c 'yum clean headers' Run this command to remove all of the packages held in the caches: su -c 'yum clean packages' In both cases, enter the root password when prompted.
Managing <command>yum</command> Repositories You may wish to create your own software repositories, or maintain a copy of another repository. Old versions of yum use a different repository utility These procedures are for repositories that are compatible with version 2.11 of yum and above. You must use the yum-arch utility that was included with yum 2.10 to enable repositories for older versions of yum.
Creating a New Repository repositories, creating A software repository is simply a directory containing package files, with a sub-directory for the package index files used by yum. Other types of files can be held in the main directory without interfering with use of the repository. The data/ sub-directory and the XML files it contains are created and updated with the createrepo utility Creating Repositories Requires an Extra Package You must install the createrepo package from &FC; in order to be able to make repositories. To make a directory into a yum repository: Copy the RPM packages that you are distributing into the directory. Open a terminal window. In the terminal window type: createrepo /path/to/directory. Substitute the path to your package directory for /path/to/directory/. In the terminal window type: chmod a+x /path/to/directory/repodata/. Substitute the path to your package directory for /path/to/directory/. Ensure that the directory is available via your chosen network protocols. The repository is now ready for use. Create a definition file for this new repository. If you are distributing packages that you have created yourself then you also need to make the GPG public key for your signature available, so that others can verify the packages. The simplest way to make these files available is to put the public key and repository definition files on the same Website or FTP site as the repository. Creating a definition file is described in . Packaging building is beyond the scope of this document. Repositories and Management Utilities The createrepo utility makes no changes to the directory other than adding a repo-data/ sub-directory. Adding index files for other utilities does not interfere with yum.
Repository Definition Files repository definition files, creating repository definition files, editing Create and edit repository definition files with a text editor. Definition files are plain-text with a standard format: Format of <command>yum</command> Repository Definition Files The baseurl must specify the complete URL for the root directory of the repository, including the http://, https:// or ftp:// prefix. You may also specify a directory on your system, by using the prefix file:// in the baseurl. Logging in to Protected Repositories To use a password-protected repository, include the correct username and password in the baseurl. For example, ftp://user:password at myrepository.com/$releasever/mypackages/. If possible, list more than one directory or server that holds a copy of the repository. This enables yum to use another repository if the first is unavailable. By default yum randomly selects repositories from the baseurl list. To force yum to use them in sequence, add the option failovermethod=priority. It is also good practice to use variables like $releasever in the URL, rather than setting these to a specific value. The available variables are listed on the man page for yum.conf. Using variables enables the same definition to function when your system is upgraded to a later version, or if the configuration is copied to another machine. A definition file is shown below that uses all of these features. In this example, copies of the repository are held in the directory /srv/software/&FED;/&FCVER;/mypackages/ on the system itself, in the directory software/&FED;/&FCVER;/mypackages/ on the Web server www.my-repository.com/, and in the directory pub/software/&FED;/&FCVER;/mypackages/ on the FTP server server.another-repository.org. Here, yum will access the FTP server with the username yum-user and the password qwerty. The failovermethod ensures that yum will check the copy on the local machine, before trying the servers in sequence. A <command>yum</command> Repository Definition File with Failover To use a list of servers, substitute mirrorlist for baseurl. Set gpgcheck=0 if it is necessary to disable signature checking for the packages provided by this repository. Avoid distributing or installing unsigned packages.
Updating a Repository repositories, updating Whenever a package is added, or replaced with a different version, you must run createrepo again for the index files to be updated. If you are mirroring an existing repository then you may assume that the site administrator updates the indexes, but for safety you should add this to your synchronization scripts. The createrepo utility can be run as frequently as you wish.
Using <command>yum</command> with a Proxy Server proxy server, with yum yum, using a proxy server Repositories may be accessed through standard proxy servers. If your system is connected to the Internet through a Web proxy server, specify the details of the server in /etc/yum.conf. The proxy setting must specify the proxy server as a complete URL, including the TCP port number. If your proxy server requires a username and password, specify these by adding proxy_username and proxy_password settings. For example, the settings below enable yum to use the proxy server mycache.mydomain.com, connecting to port 3128, with the username yum-user and the password qwerty. Configuration File Settings for Using A Proxy Server Global Settings Defining a proxy server in /etc/yum.conf means that all users connect to the proxy server with those details when using yum. To enable proxy access for a specific user, add the lines in the example box below to their shell profile. For the default bash shell, the profile is the file .bash_profile. The settings below enable yum to use the proxy server mycache.mydomain.com, connecting to port 3128. Profile Settings for Using a Proxy Server If the proxy server requires a username and password then add these to the URL. For example, to include the username yum-user and the password qwerty: Profile Settings for a Secured Proxy Server <command>http_proxy</command> Variable with Other Utilities The http_proxy variable is also used by curl and other utilities. Although yum itself may use http_proxy in either upper-case or lower-case, curl requires the name of the variable to be in lower-case.
From fedora-docs-commits at redhat.com Mon Jun 27 18:40:35 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Mon, 27 Jun 2005 14:40:35 -0400 Subject: xml-normalize 010-text.xml,1.4,1.5 Message-ID: <200506271840.j5RIeZOh013189@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv13168 Modified Files: 010-text.xml Log Message: RIght shifted. Index: 010-text.xml =================================================================== RCS file: /cvs/docs/xml-normalize/010-text.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- 010-text.xml 27 Jun 2005 17:30:34 -0000 1.4 +++ 010-text.xml 27 Jun 2005 18:40:32 -0000 1.5 @@ -1,16 +1,16 @@ - - - - - + + + + + + - ]> + ]> Linux Device Drivers From fedora-docs-commits at redhat.com Mon Jun 27 19:08:05 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Mon, 27 Jun 2005 15:08:05 -0400 Subject: xml-normalize yum-software-management-en.xml,1.1,1.2 Message-ID: <200506271908.j5RJ85E2014378@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14357 Modified Files: yum-software-management-en.xml Log Message: Testing xml-normalize, this might be very large... sorry. From fedora-docs-commits at redhat.com Mon Jun 27 19:12:52 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Mon, 27 Jun 2005 15:12:52 -0400 Subject: xml-normalize yum-software-management-en.xml,1.2,1.3 Message-ID: <200506271912.j5RJCq9s014459@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/xml-normalize In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14438 Modified Files: yum-software-management-en.xml Log Message: Another xml-norm test with a one line change... how big will the diff be? Index: yum-software-management-en.xml =================================================================== RCS file: /cvs/docs/xml-normalize/yum-software-management-en.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- yum-software-management-en.xml 27 Jun 2005 19:08:03 -0000 1.2 +++ yum-software-management-en.xml 27 Jun 2005 19:12:49 -0000 1.3 @@ -56,7 +56,7 @@ yum an essential tool.
- +
Using This Document From fedora-docs-commits at redhat.com Mon Jun 27 19:43:15 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Mon, 27 Jun 2005 15:43:15 -0400 Subject: docs-common/bin - New directory Message-ID: <200506271943.j5RJhFWu014592@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common/bin In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14578/bin Log Message: Directory /cvs/docs/docs-common/bin added to the repository From fedora-docs-commits at redhat.com Mon Jun 27 19:49:23 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Mon, 27 Jun 2005 15:49:23 -0400 Subject: docs-common README,1.9,1.10 Message-ID: <200506271949.j5RJnN3B014658@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14622 Modified Files: README Log Message: Make the XML format normalization tools available to the client side. Index: README =================================================================== RCS file: /cvs/docs/docs-common/README,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- README 11 May 2005 16:08:57 -0000 1.9 +++ README 27 Jun 2005 19:49:20 -0000 1.10 @@ -8,6 +8,10 @@ Four modules comprise the minimal set that must be obtained to view or edit any document: + bin/ + + Client-side scripts and tools. + common/ DocBook XML files shared by multiple guides. From fedora-docs-commits at redhat.com Mon Jun 27 19:49:23 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Mon, 27 Jun 2005 15:49:23 -0400 Subject: docs-common/bin tidy-bowl, NONE, 1.1 xmlformat, NONE, 1.1 xmlformat-fdp.conf, NONE, 1.1 Message-ID: <200506271949.j5RJnNS4014663@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common/bin In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv14622/bin Added Files: tidy-bowl xmlformat xmlformat-fdp.conf Log Message: Make the XML format normalization tools available to the client side. --- NEW FILE tidy-bowl --- #!/bin/sh ######################################################################## # # This script is invoked by "commitinfo" just after the incoming file has # been uploaded to the server. It gets passed these arguments: # # tidy-bowl file ... # # If we approve of the commit for EVERY file in the list, then we return # a zero (0). Any non-zero return aborts the commit, so we must be very # careful here. # # AFAIK, the $PWD is the temporary file where the incoming "file" is located, # but that needs to be verified. # # For every "file" that ends with ".xml", we will attempt to normalize the # formatting by using tidy(1) to prettyprint it. We must overwrite "file" so # that the rest of CVS knows where to find the file. # # There doesn't seem to be any way to return error messages, so we'll just bang # them out to "/var/log/messages". # ######################################################################## # exit 0 # Early exit while frobbing around ######################################################################## # All ancillary files should be in the same directory as this script ME=`/bin/basename $0` PREFIX=`/usr/bin/dirname $0` ######################################################################## USAGE="Usage: ${ME} [-T tool] [-t tool-args] file..." NORMTOOL=${PREFIX}/xmlformat NORMARGS="-i -v -f ${PREFIX}/xmlformat-fdp.conf" while getopts T:t: c do case "${c}" in T) NORMTOOL="${OPTARG}";; t) NORMARGS="${OPTARG}";; *) /bin/echo "${USAGE}" >&2; exit 1;; esac done shift `/usr/bin/expr "${OPTIND}" - 1` ######################################################################## for fn in $@ do case "${fn}" in *.[Xx][Mm][Ll] ) # Make sure we can find the input file if [ ! -f "${fn}" ]; then /bin/echo $0 "Cannot find '${fn}'" exit 1 fi # Try to clean it up ${NORMTOOL} ${NORMARGS} "${fn}" if [ $? -ne 0 ]; then /bin/echo $0 "File '${fn}' unclean." exit 1 fi ;; * ) ;; esac done exit 0 --- NEW FILE xmlformat --- #! /usr/bin/perl -w # vim:set ts=2 sw=2 expandtab: # xmlformat - configurable XML file formatter/pretty-printer # Copyright (c) 2004, Kitebird, LLC. All rights reserved. # Some portions are based on the REX shallow XML parser, which # is Copyright (c) 1998, Robert D. Cameron. These include the # regular expression parsing variables and the shallow_parse() # method. # This software is licensed as described in the file LICENSE, # which you should have received as part of this distribution. # Syntax: xmlformat [config-file] xml-file # Default config file is $ENV{XMLFORMAT_CONF} or ./xmlformat.conf, in that # order. # Paul DuBois # paul at kitebird.com # 2003-12-14 # The input document first is parsed into a list of strings. Each string # represents one of the following: # - text node # - processing instruction (the XML declaration is treated as a PI) # - comment # - CDATA section # - DOCTYPE declaration # - element tag (either , , or ), *including attributes* # Entities are left untouched. They appear in their original form as part # of the text node in which they occur. # The list of strings then is converted to a hierarchical structure. # The document top level is represented by a reference to a list. # Each list element is a reference to a node -- a hash that has "type" # and "content" key/value pairs. The "type" key indicates the node # type and has one of the following values: # "text" - text node # "pi" - processing instruction node # "comment" - comment node # "CDATA" - CDATA section node # "DOCTYPE" - DOCTYPE node # "elt" - element node # (For purposes of this program, it's really only necessary to have "text", # "elt", and "other". The types other than "text" and "elt" currently are # all treated the same way.) # For all but element nodes, the "content" value is the text of the node. # For element nodes, the "content" hash is a reference to a list of # nodes for the element's children. In addition, an element node has # three additional key/value pairs: # - The "name" value is the tag name within the opening tag, minus angle # brackets or attributes. # - The "open_tag" value is the full opening tag, which may also be the # closing tag. # - The "close_tag" value depends on the opening tag. If the open tag is # "", the close tag is "". If the open tag is "", the # close tag is the empty string. # If the tree structure is converted back into a string with # tree_stringify(), the result can be compared to the input file # as a regression test. The string should be identical to the original # input document. use strict; use Getopt::Long; $Getopt::Long::ignorecase = 0; # options are case sensitive $Getopt::Long::bundling = 1; # allow short options to be bundled my $XMLFORMAT_VERSION = "1.03"; my $prog_name = "xmlformat"; # ---------------------------------------------------------------------- package XMLFormat; use strict; # ---------------------------------------------------------------------- # Regular expressions for parsing document components. Based on REX. # SPE = shallow parsing expression # SE = scanning expression # CE = completion expression # RSB = right square brackets # QM = question mark my $TextSE = "[^<]+"; my $UntilHyphen = "[^-]*-"; my $Until2Hyphens = "$UntilHyphen(?:[^-]$UntilHyphen)*-"; my $CommentCE = "$Until2Hyphens>?"; my $UntilRSBs = "[^\\]]*\\](?:[^\\]]+\\])*\\]+"; my $CDATA_CE = "$UntilRSBs(?:[^\\]>]$UntilRSBs)*>"; my $S = "[ \\n\\t\\r]+"; my $NameStrt = "[A-Za-z_:]|[^\\x00-\\x7F]"; my $NameChar = "[A-Za-z0-9_:.-]|[^\\x00-\\x7F]"; my $Name = "(?:$NameStrt)(?:$NameChar)*"; my $QuoteSE = "\"[^\"]*\"|'[^']*'"; my $DT_IdentSE = "$S$Name(?:$S(?:$Name|$QuoteSE))*"; my $MarkupDeclCE = "(?:[^\\]\"'><]+|$QuoteSE)*>"; my $S1 = "[\\n\\r\\t ]"; my $UntilQMs = "[^?]*\\?+"; my $PI_Tail = "\\?>|$S1$UntilQMs(?:[^>?]$UntilQMs)*>"; my $DT_ItemSE = "<(?:!(?:--$Until2Hyphens>|[^-]$MarkupDeclCE)|\\?$Name(?:$PI_Tail))|%$Name;|$S"; my $DocTypeCE = "$DT_IdentSE(?:$S)?(?:\\[(?:$DT_ItemSE)*\\](?:$S)?)?>?"; my $DeclCE = "--(?:$CommentCE)?|\\[CDATA\\[(?:$CDATA_CE)?|DOCTYPE(?:$DocTypeCE)?"; my $PI_CE = "$Name(?:$PI_Tail)?"; my $EndTagCE = "$Name(?:$S)?>?"; my $AttValSE = "\"[^<\"]*\"|'[^<']*'"; my $ElemTagCE = "$Name(?:$S$Name(?:$S)?=(?:$S)?(?:$AttValSE))*(?:$S)?/?>?"; my $MarkupSPE = "<(?:!(?:$DeclCE)?|\\?(?:$PI_CE)?|/(?:$EndTagCE)?|(?:$ElemTagCE)?)"; my $XML_SPE = "$TextSE|$MarkupSPE"; # ---------------------------------------------------------------------- # Allowable options and their possible values: # - The keys of this hash are the allowable option names # - The value for each key is list of allowable option values # - If the value is undef, the option value must be numeric # If any new formatting option is added to this program, it # must be specified here, *and* a default value for it should # be listed in the *DOCUMENT and *DEFAULT pseudo-element # option hashes. my %opt_list = ( "format" => [ "block", "inline", "verbatim" ], "normalize" => [ "yes", "no" ], "subindent" => undef, "wrap-length" => undef, "entry-break" => undef, "exit-break" => undef, "element-break" => undef ); # Object creation: set up the default formatting configuration # and variables for maintaining input and output document. sub new { my $type = shift; my $self = {}; # Formatting options for each element. $self->{elt_opts} = { }; # The formatting options for the *DOCUMENT and *DEFAULT pseudo-elements can # be overridden in the configuration file, but the options must also be # built in to make sure they exist if not specified in the configuration # file. Each of the structures must have a value for every option. # Options for top-level document children. # - Do not change entry-break: 0 ensures no extra newlines before # first element of output. # - Do not change exit-break: 1 ensures a newline after final element # of output document. # - It's probably best not to change any of the others, except perhaps # if you want to increase the element-break. $self->{elt_opts}->{"*DOCUMENT"} = { "format" => "block", "normalize" => "no", "subindent" => 0, "wrap-length" => 0, "entry-break" => 0, # do not change "exit-break" => 1, # do not change "element-break" => 1 }; # Default options. These are used for any elements in the document # that are not specified explicitly in the configuration file. $self->{elt_opts}->{"*DEFAULT"} = { "format" => "block", "normalize" => "no", "subindent" => 1, "wrap-length" => 0, "entry-break" => 1, "exit-break" => 1, "element-break" => 1 }; # Run the *DOCUMENT and *DEFAULT options through the option-checker # to verify that the built-in values are legal. my $err_count = 0; foreach my $elt_name (keys (%{$self->{elt_opts}})) # ... for each element { # Check each option for element while (my ($opt_name, $opt_val) = each (%{$self->{elt_opts}->{$elt_name}})) { my $err_msg; ($opt_val, $err_msg) = check_option ($opt_name, $opt_val); if (!defined ($err_msg)) { $self->{elt_opts}->{$elt_name}->{$opt_name} = $opt_val; } else { warn "LOGIC ERROR: $elt_name default option is invalid\n"; warn "$err_msg\n"; ++$err_count; } } } # Make sure that the every option is represented in the # *DOCUMENT and *DEFAULT structures. foreach my $opt_name (keys (%opt_list)) { foreach my $elt_name (keys (%{$self->{elt_opts}})) { if (!exists ($self->{elt_opts}->{$elt_name}->{$opt_name})) { warn "LOGIC ERROR: $elt_name has no default '$opt_name' option\n"; ++$err_count; } } } die "Cannot continue; internal default formatting options must be fixed\n" if $err_count > 0; bless $self, $type; # bless object and return it } # Initialize the variables that are used per-document sub init_doc_vars { my $self = shift; # Elements that are used in the document but not named explicitly # in the configuration file. $self->{unconf_elts} = { }; # List of tokens for current document. $self->{tokens} = [ ]; # Document node tree (constructed from the token list). $self->{tree} = [ ]; # Variables for formatting operations: # out_doc = resulting output document (constructed from document tree) # pending = array of pending tokens being held until flushed $self->{out_doc} = ""; $self->{pending} = [ ]; # Inline elements within block elements are processed using the # text normalization (and possible line-wrapping) values of their # enclosing block. Blocks and inlines may be nested, so we maintain # a stack that allows the normalize/wrap-length values of the current # block to be determined. $self->{block_name_stack} = [ ]; # for debugging $self->{block_opts_stack} = [ ]; # A similar stack for maintaining each block's current break type. $self->{block_break_type_stack} = [ ]; } # Accessors for token list and resulting output document sub tokens { my $self = shift; return $self->{tokens}; } sub out_doc { my $self = shift; return $self->{out_doc}; } # Methods for adding strings to output document or # to the pending output array sub add_to_doc { my ($self, $str) = @_; $self->{out_doc} .= $str; } sub add_to_pending { my ($self, $str) = @_; push (@{$self->{pending}}, $str); } # Block stack mainenance methods # Push options onto or pop options off from the stack. When doing # this, also push or pop an element onto the break-level stack. sub begin_block { my ($self, $name, $opts) = @_; push (@{$self->{block_name_stack}}, $name); push (@{$self->{block_opts_stack}}, $opts); push (@{$self->{block_break_type_stack}}, "entry-break"); } sub end_block { my $self = shift; pop (@{$self->{block_name_stack}}); pop (@{$self->{block_opts_stack}}); pop (@{$self->{block_break_type_stack}}); } # Return the current block's normalization status or wrap length sub block_normalize { my $self = shift; my $size = @{$self->{block_opts_stack}}; my $opts = $self->{block_opts_stack}->[$size-1]; return $opts->{normalize} eq "yes"; } sub block_wrap_length { my $self = shift; my $size = @{$self->{block_opts_stack}}; my $opts = $self->{block_opts_stack}->[$size-1]; return $opts->{"wrap-length"}; } # Set the current block's break type, or return the number of newlines # for the block's break type sub set_block_break_type { my ($self, $type) = @_; my $size = @{$self->{block_break_type_stack}}; $self->{block_break_type_stack}->[$size-1] = $type; } sub block_break_value { my $self = shift; my $size = @{$self->{block_opts_stack}}; my $opts = $self->{block_opts_stack}->[$size-1]; $size = @{$self->{block_break_type_stack}}; my $type = $self->{block_break_type_stack}->[$size-1]; return $opts->{$type}; } # ---------------------------------------------------------------------- # Read configuration information. For each element, construct a hash # containing a hash key and value for each option name and value. # After reading the file, fill in missing option values for # incomplete option structures using the *DEFAULT options. sub read_config { my $self = shift; my $conf_file = shift; my @elt_names = (); my $err_msg; my $in_continuation = 0; my $saved_line = ""; open (FH, $conf_file) or die "Cannot read config file $conf_file: $!\n"; while () { chomp; next if /^\s*($|#)/; # skip blank lines, comments if ($in_continuation) { $_ = $saved_line . " " . $_; $saved_line = ""; $in_continuation = 0; } if (!/^\s/) { # Line doesn't begin with whitespace, so it lists element names. # Names are separated by whitespace or commas, possibly followed # by a continuation character or a comment. if (/\\$/) { s/\\$//; # remove continuation character $saved_line = $_; $in_continuation = 1; next; } s/\s*#.*$//; # remove any trailing comment @elt_names = split (/[\s,]+/, $_); # make sure each name has an entry in the elt_opts structure foreach my $elt_name (@elt_names) { $self->{elt_opts}->{$elt_name} = { } unless exists ($self->{elt_opts}->{$elt_name}); } } else { # Line begins with whitespace, so it contains an option # to apply to the current element list, possibly followed by # a comment. First check that there is a current list. # Then parse the option name/value. die "$conf_file:$.: Option setting found before any " . "elements were named.\n" if !@elt_names; s/\s*#.*$//; my ($opt_name, $opt_val) = /^\s+(\S+)(?:\s+|\s*=\s*)(\S+)$/; die "$conf_file:$.: Malformed line: $_\n" unless defined ($opt_val); # Check option. If illegal, die with message. Otherwise, # add option to each element in current element list ($opt_val, $err_msg) = check_option ($opt_name, $opt_val); die "$conf_file:$.: $err_msg\n" if defined ($err_msg); foreach my $elt_name (@elt_names) { $self->{elt_opts}->{$elt_name}->{$opt_name} = $opt_val; } } } close (FH); # For any element that has missing option values, fill in the values # using the options for the *DEFAULT pseudo-element. This speeds up # element option lookups later. It also makes it unnecessary to test # each option to see if it's defined: All element option structures # will have every option defined. my $def_opts = $self->{elt_opts}->{"*DEFAULT"}; foreach my $elt_name (keys (%{$self->{elt_opts}})) { next if $elt_name eq "*DEFAULT"; foreach my $opt_name (keys (%{$def_opts})) { next if exists ($self->{elt_opts}->{$elt_name}->{$opt_name}); # already set $self->{elt_opts}->{$elt_name}->{$opt_name} = $def_opts->{$opt_name}; } } } # Check option name to make sure it's legal. Check the value to make sure # that it's legal for the name. Return a two-element array: # (value, undef) if the option name and value are legal. # (undef, message) if an error was found; message contains error message. # For legal values, the returned value should be assigned to the option, # because it may get type-converted here. sub check_option { my ($opt_name, $opt_val) = @_; # - Check option name to make sure it's a legal option # - Then check the value. If there is a list of values # the value must be one of them. Otherwise, the value # must be an integer. return (undef, "Unknown option name: $opt_name") unless exists ($opt_list{$opt_name}); my $allowable_val = $opt_list{$opt_name}; if (defined ($allowable_val)) { return (undef, "Unknown '$opt_name' value: $opt_val") unless grep (/^$opt_val$/, @{$allowable_val}); } else # other options should be numeric { # "$opt_val" converts $opt_val to string for pattern match return (undef, "'$opt_name' value ($opt_val) should be an integer") unless "$opt_val" =~ /^\d+$/; } return ($opt_val, undef); } # Return hash of option values for a given element. If no options are found: # - Add the element name to the list of unconfigured options. # - Assign the default options to the element. (This way the test for the # option fails only once.) sub get_opts { my $self = shift; my $elt_name = shift; my $opts = $self->{elt_opts}->{$elt_name}; if (!defined ($opts)) { $self->{unconf_elts}->{$elt_name} = 1; $opts = $self->{elt_opts}->{$elt_name} = $self->{elt_opts}->{"*DEFAULT"}; } return $opts; } # Display contents of configuration options to be used to process document. # For each element named in the elt_opts structure, display its format # type, and those options that apply to the type. sub display_config { my $self = shift; # Format types and the additional options that apply to each type my $format_opts = { "block" => [ "entry-break", "element-break", "exit-break", "subindent", "normalize", "wrap-length" ], "inline" => [ ], "verbatim" => [ ] }; foreach my $elt_name (sort (keys (%{$self->{elt_opts}}))) { print "$elt_name\n"; my %opts = %{$self->{elt_opts}->{$elt_name}}; my $format = $opts{format}; # Write out format type, then options that apply to the format type print " format = $format\n"; foreach my $opt_name (@{$format_opts->{$format}}) { print " $opt_name = $opts{$opt_name}\n"; } print "\n"; } } # Display the list of elements that are used in the document but not # configured in the configuration file. # Then re-unconfigure the elements so that they won't be considered # as configured for the next document, if there is one. sub display_unconfigured_elements { my $self = shift; my @elts = keys (%{$self->{unconf_elts}}); if (@elts == 0) { print "The document contains no unconfigured elements.\n"; } else { print "The following document elements were assigned no formatting options:\n"; foreach my $line ($self->line_wrap ([ join (" ", sort (@elts)) ], 0, 0, 65)) { print "$line\n"; } } foreach my $elt_name (@elts) { delete ($self->{elt_opts}->{$elt_name}); } } # ---------------------------------------------------------------------- # Main document processing routine. # - Argument is a string representing an input document # - Return value is the reformatted document, or undef. An undef return # signifies either than an error occurred, or that some option was # given that suppresses document output. In either case, don't write # any output for the document. Any error messages will already have # been printed when this returns. sub process_doc { my $self = shift; my ($doc, $verbose, $check_parser, $canonize_only, $show_unconf_elts) = @_; my $str; $self->init_doc_vars (); # Perform lexical parse to split document into list of tokens warn "Parsing document...\n" if $verbose; $self->shallow_parse ($doc); if ($check_parser) { warn "Checking parser...\n" if $verbose; # concatentation of tokens should be identical to original document if ($doc eq join ("", @{$self->tokens ()})) { print "Parser is okay\n"; } else { print "PARSER ERROR: document token concatenation differs from document\n"; } return undef; } # Look for and report any error tokens returned by parser warn "Checking document for errors...\n" if $verbose; if ($self->report_errors () > 0) { warn "Cannot continue processing document.\n"; return undef; } # Convert the token list to a tree structure warn "Converting document tokens to tree...\n" if $verbose; if ($self->tokens_to_tree () > 0) { warn "Cannot continue processing document.\n"; return undef; } # Check: Stringify the tree to convert it back to a single string, # then compare to original document string (should be identical) # (This is an integrity check on the validity of the to-tree and stringify # operations; if one or both do not work properly, a mismatch should occur.) #$str = $self->tree_stringify (); #print $str; #warn "ERROR: mismatch between document and resulting string\n" if $doc ne $str; # Canonize tree to remove extraneous whitespace warn "Canonizing document tree...\n" if $verbose; $self->tree_canonize (); if ($canonize_only) { print $self->tree_stringify () . "\n"; return undef; } # One side-effect of canonizing the tree is that the formatting # options are looked up for each element in the document. That # causes the list of elements that have no explicit configuration # to be built. Display the list and return if user requested it. if ($show_unconf_elts) { $self->display_unconfigured_elements (); return undef; } # Format the tree to produce formatted XML as a single string warn "Formatting document tree...\n" if $verbose; $self->tree_format (); # If the document is not empty, add a newline and emit a warning if # reformatting failed to add a trailing newline. This shouldn't # happen if the *DOCUMENT options are set up with exit-break = 1, # which is the reason for the warning rather than just silently # adding the newline. $str = $self->out_doc (); if ($str ne "" && $str !~ /\n$/) { warn "LOGIC ERROR: trailing newline had to be added\n"; $str .= "\n"; } return $str; } # ---------------------------------------------------------------------- sub shallow_parse { my ($self, $xml_document) = @_; $self->{tokens} = [ $xml_document =~ /$XML_SPE/g ]; } # Extract a tag name from a tag and return it. # Dies if the tag cannot be found, because this is supposed to be # called only with a legal tag. sub extract_tag_name { my $tag = shift; die "Cannot find tag name in tag: $tag\n" unless $tag =~ /^<\/?($Name)/; return $1; } # ---------------------------------------------------------------------- # Check token list for errors and report any that are found. Error # tokens are those that begin with "<" but do not end with ">". # Returns the error count. # Does not modify the original token list. sub report_errors { my $self = shift; my $err_count = 0; for (my $i = 0; $i < @{$self->{tokens}}; $i++) { my $token = $self->{tokens}->[$i]; if ($token =~ /^$/) { warn "Error (token " . ($i+1) . "): $token\n"; ++$err_count; } } warn "Number of errors found: $err_count\n" if $err_count > 0; return $err_count; } # ---------------------------------------------------------------------- # Convert the list of XML document tokens to a tree representation. # The implementation uses a loop and a stack rather than recursion. # Does not modify the original token list. # Returns an error count. sub tokens_to_tree { my $self = shift; my @tag_stack = (); # stack for element tags my @children_stack = (); # stack for lists of children my $children = [ ]; # current list of children my $err_count = 0; for (my $i = 0; $i < @{$self->{tokens}}; $i++) { my $token = $self->{tokens}->[$i]; if ($token !~ /^), close the # element immediately, giving it an empty child list. # - Otherwise, push tag and child list on stacks, begin new child # list for element body. if ($token =~ /\/>$/) # tag is of form { push (@{$children}, element_node ($token, "", [ ])); } else # tag is of form { push (@tag_stack, $token); push (@children_stack, $children); $children = [ ]; } } } # At this point, the stacks should be empty if the document is # well-formed. if (@tag_stack) { warn "Non-empty tag stack; malformed document?\n"; ++$err_count; } if (@children_stack) { warn "Non-empty children stack; malformed document?\n"; ++$err_count; } $self->{tree} = $children; return $err_count; } # Node-generating helper methods for tokens_to_tree # Generic node generator sub node { return { "type" => $_[0], "content" => $_[1] }; } # Generators for specific non-element nodes sub text_node { return node ("text", $_[0]); } sub comment_node { return node ("comment", $_[0]); } sub pi_node { return node ("pi", $_[0]); } sub doctype_node { return node ("DOCTYPE", $_[0]); } sub cdata_node { return node ("CDATA", $_[0]); } # For an element node, create a standard node with the type and content # key/value pairs. Then add pairs for the "name", "open_tag", and # "close_tag" hash keys. sub element_node { my ($open_tag, $close_tag, $children) = @_; my $elt = node ("elt", $children); # name is the open tag with angle brackets and attibutes stripped $elt->{name} = extract_tag_name ($open_tag); $elt->{open_tag} = $open_tag; $elt->{close_tag} = $close_tag; return $elt; } # ---------------------------------------------------------------------- # Convert the given XML document tree (or subtree) to string form by # concatentating all of its components. Argument is a reference # to a list of nodes at a given level of the tree. # Does not modify the node list. sub tree_stringify { my $self = shift; my $children = shift || $self->{tree}; # use entire tree if no arg; my $str = ""; for (my $i = 0; $i < @{$children}; $i++) { my $child = $children->[$i]; # - Elements have list of child nodes as content (process recursively) # - All other node types have text content if ($child->{type} eq "elt") { $str .= $child->{open_tag} . $self->tree_stringify ($child->{content}) . $child->{close_tag}; } else { $str .= $child->{content}; } } return $str; } # ---------------------------------------------------------------------- # Put tree in "canonical" form by eliminating extraneous whitespace # from element text content. # $children is a list of child nodes # This function modifies the node list. # Canonizing occurs as follows: # - Comment, PI, DOCTYPE, and CDATA nodes remain untouched # - Verbatim elements and their descendants remain untouched # - Within non-normalized block elements: # - Delete all-whitespace text node children # - Leave other text node children untouched # - Within normalized block elements: # - Convert runs of whitespace (including line-endings) to single spaces # - Trim leading whitespace of first text node # - Trim trailing whitespace of last text node # - Trim whitespace that is adjacent to a verbatim or non-normalized # sub-element. (For example, if a is followed by # more text, delete any whitespace at beginning of that text.) # - Within inline elements: # - Normalize the same way as the enclosing block element, with the # exception that a space at the beginning or end is not removed. # (Otherwise, three blind mice # would become threeblindmice.) sub tree_canonize { my $self = shift; $self->{tree} = $self->tree_canonize2 ($self->{tree}, "*DOCUMENT"); } sub tree_canonize2 { my $self = shift; my $children = shift; my $par_name = shift; # Formatting options for parent my $par_opts = $self->get_opts ($par_name); # If parent is a block element, remember its formatting options on # the block stack so they can be used to control canonization of # inline child elements. $self->begin_block ($par_name, $par_opts) if $par_opts->{format} eq "block"; # Iterate through list of child nodes to preserve, modify, or # discard whitespace. Return resulting list of children. # Canonize element and text nodes. Leave everything else (comments, # processing instructions, etc.) untouched. my @new_children = (); while (@{$children}) { my $child = shift (@{$children}); if ($child->{type} eq "elt") { # Leave verbatim elements untouched. For other element nodes, # canonize child list using options appropriate to element. if ($self->get_opts ($child->{name})->{format} ne "verbatim") { $child->{content} = $self->tree_canonize2 ($child->{content}, $child->{name}); } } elsif ($child->{type} eq "text") { # Delete all-whitespace node or strip whitespace as appropriate. # Paranoia check: We should never get here for verbatim elements, # because normalization is irrelevant for them. die "LOGIC ERROR: trying to canonize verbatim element $par_name!\n" if $par_opts->{format} eq "verbatim"; if (!$self->block_normalize ()) { # Enclosing block is not normalized: # - Delete child all-whitespace text nodes. # - Leave other text nodes untouched. next if $child->{content} =~ /^\s*$/; } else { # Enclosing block is normalized, so normalize this text node: # - Convert runs of whitespace characters (including # line-endings characters) to single spaces. # - Trim leading whitespace if this node is the first child # of a block element or it follows a non-normalized node. # - Trim leading whitespace if this node is the last child # of a block element or it precedes a non-normalized node. # These are nil if there is no prev or next child my $prev_child = $new_children[$#new_children]; my $next_child = $children->[0]; $child->{content} =~ s/\s+/ /g; $child->{content} =~ s/^ // if (!defined ($prev_child) && $par_opts->{format} eq "block") || $self->non_normalized_node ($prev_child); $child->{content} =~ s/ $// if (!defined ($next_child) && $par_opts->{format} eq "block") || $self->non_normalized_node ($next_child); # If resulting text is empty, discard the node. next if $child->{content} =~ /^$/; } } push (@new_children, $child); } # Pop block stack if parent was a block element $self->end_block () if $par_opts->{format} eq "block"; return \@new_children; } # Helper function for tree_canonize(). # Determine whether a node is normalized. This is used to check # the node that is adjacent to a given text node (either previous # or following). # - No is node is nil # - No if the node is a verbatim element # - If the node is a block element, yes or no according to its # normalize option # - No if the node is an inline element. Inlines are normalized # if the parent block is normalized, but this method is not called # except while examinine normalized blocks. So its inline children # are also normalized. # - No if node is a comment, PI, DOCTYPE, or CDATA section. These are # treated like verbatim elements. sub non_normalized_node { my $self = shift; my $node = shift; return 0 if !$node; my $type = $node->{type}; if ($type eq "elt") { my $node_opts = $self->get_opts ($node->{name}); if ($node_opts->{format} eq "verbatim") { return 1; } if ($node_opts->{format} eq "block") { return $node_opts->{normalize} eq "no"; } if ($node_opts->{format} eq "inline") { return 0; } die "LOGIC ERROR: non_normalized_node: unhandled node format.\n"; } if ($type eq "comment" || $type eq "pi" || $type eq "DOCTYPE" || $type eq "CDATA") { return 1; } if ($type eq "text") { die "LOGIC ERROR: non_normalized_node: got called for text node.\n"; } die "LOGIC ERROR: non_normalized_node: unhandled node type.\n"; } # ---------------------------------------------------------------------- # Format (pretty-print) the document tree # Does not modify the node list. # The class maintains two variables for storing output: # - out_doc stores content that has been seen and "flushed". # - pending stores an array of strings (content of text nodes and inline # element tags). These are held until they need to be flushed, at # which point they are concatenated and possibly wrapped/indented. # Flushing occurs when a break needs to be written, which happens # when something other than a text node or inline element is seen. # If parent name and children are not given, format the entire document. # Assume prevailing indent = 0 if not given. sub tree_format { my $self = shift; my $par_name = shift || "*DOCUMENT"; # format entire document if no arg my $children = shift || $self->{tree}; # use entire tree if no arg my $indent = shift || 0; # Formatting options for parent element my $par_opts = $self->get_opts ($par_name); # If parent is a block element: # - Remember its formatting options on the block stack so they can # be used to control formatting of inline child elements. # - Set initial break type to entry-break. # - Shift prevailing indent right before generating child content. if ($par_opts->{format} eq "block") { $self->begin_block ($par_name, $par_opts); $self->set_block_break_type ("entry-break"); $indent += $par_opts->{"subindent"}; } # Variables for keeping track of whether the previous child # was a text node. Used for controlling break behavior in # non-normalized block elements: No line breaks are added around # text in such elements, nor is indenting added. my $prev_child_is_text = 0; my $cur_child_is_text = 0; foreach my $child (@{$children}) { $prev_child_is_text = $cur_child_is_text; # Text nodes: just add text to pending output if ($child->{type} eq "text") { $cur_child_is_text = 1; $self->add_to_pending ($child->{content}); next; } $cur_child_is_text = 0; # Element nodes: handle depending on format type if ($child->{type} eq "elt") { my $child_opts = $self->get_opts ($child->{name}); # Verbatim elements: # - Print literally without change (use _stringify). # - Do not line-wrap or add any indent. if ($child_opts->{format} eq "verbatim") { $self->flush_pending ($indent); $self->emit_break (0) unless $prev_child_is_text && !$self->block_normalize (); $self->set_block_break_type ("element-break"); $self->add_to_doc ($child->{open_tag} . $self->tree_stringify ($child->{content}) . $child->{close_tag}); next; } # Inline elements: # - Do not break or indent. # - Do not line-wrap content; just add content to pending output # and let it be wrapped as part of parent's content. if ($child_opts->{format} eq "inline") { $self->add_to_pending ($child->{open_tag}); $self->tree_format ($child->{name}, $child->{content}, $indent); $self->add_to_pending ($child->{close_tag}); next; } # If we get here, node is a block element. # - Break and flush any pending output # - Break and indent (no indent if break count is zero) # - Process element itself: # - Put out opening tag # - Put out element content # - Put out any indent needed before closing tag. None needed if: # - Element's exit-break is 0 (closing tag is not on new line, # so don't indent it) # - There is no separate closing tag (it was in format) # - Element has no children (tags will be written as # , so don't indent closing tag) # - Element has children, but the block is not normalized and # the last child is a text node # - Put out closing tag $self->flush_pending ($indent); $self->emit_break ($indent) unless $prev_child_is_text && !$self->block_normalize (); $self->set_block_break_type ("element-break"); $self->add_to_doc ($child->{open_tag}); $self->tree_format ($child->{name}, $child->{content}, $indent); $self->add_to_doc (" " x $indent) unless $child_opts->{"exit-break"} <= 0 || $child->{close_tag} eq "" || !@{$child->{content}} || (@{$child->{content}} && $child->{content}->[$#{$child->{content}}]->{type} eq "text" && $child_opts->{normalize} eq "no"); $self->add_to_doc ($child->{close_tag}); next; } # Comments, PIs, etc. (everything other than text and elements), # treat similarly to verbatim block: # - Flush any pending output # - Put out a break # - Add node content to collected output $self->flush_pending ($indent); $self->emit_break (0) unless $prev_child_is_text && !$self->block_normalize (); $self->set_block_break_type ("element-break"); $self->add_to_doc ($child->{content}); } $prev_child_is_text = $cur_child_is_text; # Done processing current element's children now. # If current element is a block element: # - If there were any children, flush any pending output and put # out the exit break. # - Pop the block stack if ($par_opts->{format} eq "block") { if (@{$children}) { $self->flush_pending ($indent); $self->set_block_break_type ("exit-break"); $self->emit_break (0) unless $prev_child_is_text && !$self->block_normalize (); } $self->end_block (); } } # Emit a break - the appropriate number of newlines according to the # enclosing block's current break type. # In addition, emit the number of spaces indicated by indent. (indent # > 0 when breaking just before emitting an element tag that should # be indented within its parent element.) # Exception: Emit no indent if break count is zero. That indicates # any following output will be written on the same output line, not # indented on a new line. # Initially, when processing a node's child list, the break type is # set to entry-break. Each subsequent break is an element-break. # (After child list has been processed, an exit-break is produced as well.) sub emit_break { my ($self, $indent) = @_; # number of newlines to emit my $break_value = $self->block_break_value (); $self->add_to_doc ("\n" x $break_value); # add indent if there *was* a break $self->add_to_doc (" " x $indent) if $indent > 0 && $break_value > 0; } # Flush pending output to output document collected thus far: # - Wrap pending contents as necessary, with indent before *each* line. # - Add pending text to output document (thus "flushing" it) # - Clear pending array. sub flush_pending { my ($self, $indent) = @_; # Do nothing if nothing to flush return if !@{$self->{pending}}; # If current block is not normalized: # - Text nodes cannot be modified (no wrapping or indent). Flush # text as is without adding a break or indent. # If current block is normalized: # - Add a break. # - If line wrap is disabled: # - Add indent if there is a break. (If there isn't a break, text # should immediately follow preceding tag, so don't add indent.) # - Add text without wrapping # - If line wrap is enabled: # - First line indent is 0 if there is no break. (Text immediately # follows preceding tag.) Otherwise first line indent is same as # prevailing indent. # - Any subsequent lines get the prevailing indent. # After flushing text, advance break type to element-break. my $s = ""; if (!$self->block_normalize ()) { $s .= join ("", @{$self->{pending}}); } else { $self->emit_break (0); my $wrap_len = $self->block_wrap_length (); my $break_value = $self->block_break_value (); if ($wrap_len <= 0) { $s .= " " x $indent if $break_value > 0; $s .= join ("", @{$self->{pending}}); } else { my $first_indent = ($break_value > 0 ? $indent : 0); # Wrap lines, then join by newlines (don't add one at end) my @lines = $self->line_wrap ($self->{pending}, $first_indent, $indent, $wrap_len); $s .= join ("\n", @lines); } } $self->add_to_doc ($s); $self->{pending} = [ ]; $self->set_block_break_type ("element-break"); } # Perform line-wrapping of string array to lines no longer than given # length (including indent). # Any word longer than line length appears by itself on line. # Return array of lines (not newline-terminated). # $strs - reference to array of text items to be joined and line-wrapped. # Each item may be: # - A tag (such as ). This should be treated as # an atomic unit, which is important for preserving inline tags intact. # - A possibly multi-word string (such as "This is a string"). In this # latter case, line-wrapping preserves internal whitespace in the # string, with the exception that if whitespace would be placed at # the end of a line, it is discarded. # $first_indent - indent for first line # $rest_indent - indent for any remaining lines # $max_len - maximum length of output lines (including indent) sub line_wrap { my ($self, $strs, $first_indent, $rest_indent, $max_len) = @_; # First, tokenize the strings my @words = (); foreach my $str (@{$strs}) { if ($str =~ /^", "word", "" gets merged to "word". But # "", " ", "word", " ", "" gets left as separate tokens. my @words2 = (); foreach my $word (@words) { # If there is a previous word that does not end with whitespace, # and the currrent word does not begin with whitespace, concatenate # current word to previous word. Otherwise append current word to # end of list of words. if (@words2 && $words2[$#words2] !~ /\s$/ && $word !~ /^\s/) { $words2[$#words2] .= $word; } else { push (@words2, $word); } } my @lines = (); my $line = ""; my $llen = 0; # set the indent for the first line my $indent = $first_indent; # saved-up whitespace to put before next non-white word my $white = ""; foreach my $word (@words2) # ... while words remain to wrap { # If word is whitespace, save it. It gets added before next # word if no line-break occurs. if ($word =~ /^\s/) { $white .= $word; next; } my $wlen = length ($word); if ($llen == 0) { # New output line; it gets at least one word (discard any # saved whitespace) $line = " " x $indent . $word; $llen = $indent + $wlen; $indent = $rest_indent; $white = ""; next; } if ($llen + length ($white) + $wlen > $max_len) { # Word (plus saved whitespace) won't fit on current line. # Begin new line (discard any saved whitespace). push (@lines, $line); $line = " " x $indent . $word; $llen = $indent + $wlen; $indent = $rest_indent; $white = ""; next; } # add word to current line with saved whitespace between $line .= $white . $word; $llen += length ($white) + $wlen; $white = ""; } # push remaining line, if any push (@lines, $line) if $line ne ""; return @lines; } 1; # ---------------------------------------------------------------------- # Begin main program package main; my $usage = < \$help, # print help message "backup|b=s" => \$backup_suffix, # make backup using suffix "canonized-output" => \$canonize_only, # print canonized document "check-parser" => \$check_parser, # verify parser integrity "config-file|f=s" => \$conf_file, # config file "in-place|i" => \$in_place, # format in place "show-config" => \$show_conf, # show configuration file # need better name "show-unconfigured-elements" => \$show_unconf_elts, # show unconfigured elements "verbose|v" => \$verbose, # be verbose "version|V" => \$show_version, # show version info ) or do { print "$usage\n"; exit (1); }; if (defined ($help)) { print "$usage\n"; exit (0); } if (defined ($show_version)) { print "$prog_name $XMLFORMAT_VERSION\n"; exit (0); } # --in-place option requires a named file warn "WARNING: --in-place/-i option ignored (requires named input files)\n" if defined ($in_place) && @ARGV == 0; # --backup/-b is meaningless without --in-place if (defined ($backup_suffix)) { if (!defined ($in_place)) { die "--backup/-b option meaningless without --in-place/-i option\n"; } } # Save input filenames my @in_file = @ARGV; my $xf = XMLFormat->new (); # If a configuration file was named explicitly, use it. An error occurs # if the file does not exist. # If no configuration file was named, fall back to: # - The file named by the environment variable XMLFORMAT_CONF, if it exists # - ./xmlformat.conf, if it exists # If no configuration file can be found at all, the built-in default options # are used. (These are set up in new().) my $env_conf_file = $ENV{XMLFORMAT_CONF}; my $def_conf_file = "./xmlformat.conf"; # If no config file was named, but XMLFORMAT_CONF is set, use its value # as the config file name. if (!defined ($conf_file)) { $conf_file = $env_conf_file if defined ($env_conf_file); } # If config file still isn't defined, use the default file if it exists. if (!defined ($conf_file)) { if (-r $def_conf_file && ! -d $def_conf_file) { $conf_file = $def_conf_file; } } if (defined ($conf_file)) { warn "Reading configuration file...\n" if $verbose; die "Configuration file '$conf_file' is not readable.\n" if ! -r $conf_file; die "Configuration file '$conf_file' is a directory.\n" if -d $conf_file; $xf->read_config ($conf_file) } if ($show_conf) # show configuration and exit { $xf->display_config (); exit(0); } my ($in_doc, $out_doc); # Process arguments. # - If no files named, read string, write to stdout. # - If files named, read and process each one. Write output to stdout # unless --in-place option was given. Make backup of original file # if --backup option was given. if (@ARGV == 0) { warn "Reading document...\n" if $verbose; { local $/ = undef; $in_doc = <>; # slurp input document as single string } $out_doc = $xf->process_doc ($in_doc, $verbose, $check_parser, $canonize_only, $show_unconf_elts); if (defined ($out_doc)) { warn "Writing output document...\n" if $verbose; print $out_doc; } } else { foreach my $file (@ARGV) { warn "Reading document $file...\n" if $verbose; open (IN, $file) or die "Cannot read $file: $!\n"; { local $/ = undef; $in_doc = ; # slurp input document as single string } close (IN); $out_doc = $xf->process_doc ($in_doc, $verbose, $check_parser, $canonize_only, $show_unconf_elts); next unless defined ($out_doc); if (defined ($in_place)) { if (defined ($backup_suffix)) { warn "Making backup of $file to $file$backup_suffix...\n" if $verbose; rename ($file, $file . $backup_suffix) or die "Could not rename $file to $file$backup_suffix: $!\n"; } warn "Writing output document to $file...\n" if $verbose; open (OUT, ">$file") or die "Cannot write to $file: $!\n"; print OUT $out_doc; close (OUT); } else { warn "Writing output document...\n" if $verbose; print $out_doc; } } } warn "Done!\n" if $verbose; exit (0); --- NEW FILE xmlformat-fdp.conf --- # Comments are treated as CDATA and not touched. It's best to set # them out from other text if possible. A doublespace is nice but # code is still code, so it's not really that important. (Down, inner # stickler...) # # ChangeLog: # * Jun 26 2005 Paul W. Frields <stickster at gmail.com> # - Initial version. # *DEFAULT format = block entry-break = 1 element-break = 1 exit-break = 1 subindent = 2 normalize = no wrap-length = 72 *DOCUMENT format = block wrap-length = 72 element-break = 2 year holder entry-break = 0 exit-break = 0 normalize = yes firstname surname othername entry-break = 0 exit-break = 0 revnumber date authorinitials entry-break = 0 exit-break = 0 revremark normalize = yes article book element-break = 2 section entry-break = 1 normalize = yes # "Normalize" means make smart whitespace decisions para example important note warning caution itemizedlist variablelist varlistentry normalize = yes title titleabbrev entry-break = 0 exit-break = 0 normalize = yes emphasis literal format = inline trademark format = inline # Do not fubar or screen programlisting format = verbatim command application filename option userinput computeroutput replaceable format = inline # The and subelements of are still block firstterm format = inline normalize = yes indexterm format = block # normalize = yes primary secondary format = block entry-break = 1 exit-break = 1 varlistentry element-break = 1 term entry-break = 0 exit-break = 0 menuchoice guilabel guimenu guisubmenu guimenuitem format = inline wordasword systemitem citetitle footnote format = inline # Make and less goofy in their use of whitespace ulink xref format = inline From fedora-docs-commits at redhat.com Tue Jun 28 21:20:52 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 28 Jun 2005 17:20:52 -0400 Subject: docs-common Makefile.common,NONE,1.1 Message-ID: <200506282120.j5SLKq9a017936@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17920 Added Files: Makefile.common Log Message: The beginnings of a common set of makefile rules and target. --- NEW FILE Makefile.common --- tarball ${DOCNAME}.tar.gz: html tar -zcf $${DOCNAME}.tar.gz ${DOCNAME} From fedora-docs-commits at redhat.com Tue Jun 28 21:25:19 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 28 Jun 2005 17:25:19 -0400 Subject: example-tutorial Makefile,1.7,1.8 Message-ID: <200506282125.j5SLPJI9017976@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17947/example-tutorial Modified Files: Makefile Log Message: Added make target "make tarball" to generate a tar(1) archive of the HTML form of a document. Index: Makefile =================================================================== RCS file: /cvs/docs/example-tutorial/Makefile,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- Makefile 14 Jun 2005 20:40:36 -0000 1.7 +++ Makefile 28 Jun 2005 21:25:16 -0000 1.8 @@ -14,11 +14,13 @@ XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: From fedora-docs-commits at redhat.com Tue Jun 28 21:25:19 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 28 Jun 2005 17:25:19 -0400 Subject: docs-common Makefile.common,1.1,1.2 Message-ID: <200506282125.j5SLPJVk017982@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv17947/docs-common Modified Files: Makefile.common Log Message: Added make target "make tarball" to generate a tar(1) archive of the HTML form of a document. Index: Makefile.common =================================================================== RCS file: /cvs/docs/docs-common/Makefile.common,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- Makefile.common 28 Jun 2005 21:20:49 -0000 1.1 +++ Makefile.common 28 Jun 2005 21:25:17 -0000 1.2 @@ -1,2 +1,2 @@ tarball ${DOCNAME}.tar.gz: html - tar -zcf $${DOCNAME}.tar.gz ${DOCNAME} + tar -zcf ${DOCNAME}.tar.gz ${DOCNAME} From fedora-docs-commits at redhat.com Tue Jun 28 21:46:47 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 17:46:47 -0400 Subject: documentation-guide Makefile, 1.5, 1.6 documentation-guide-en.xml, 1.18, 1.19 Message-ID: <200506282146.j5SLklTm018089@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/documentation-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18070 Modified Files: Makefile documentation-guide-en.xml Log Message: Fixed entity file references and Makefile Index: Makefile =================================================================== RCS file: /cvs/docs/documentation-guide/Makefile,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- Makefile 24 Feb 2004 19:14:14 -0000 1.5 +++ Makefile 28 Jun 2005 21:46:45 -0000 1.6 @@ -7,18 +7,20 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = documentation-guide-$(LANG) XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: @@ -26,4 +28,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz Index: documentation-guide-en.xml =================================================================== RCS file: /cvs/docs/documentation-guide/documentation-guide-en.xml,v retrieving revision 1.18 retrieving revision 1.19 diff -u -r1.18 -r1.19 --- documentation-guide-en.xml 3 May 2005 18:52:42 -0000 1.18 +++ documentation-guide-en.xml 28 Jun 2005 21:46:45 -0000 1.19 @@ -4,14 +4,14 @@ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ - + %FEDORA-ENTITIES-EN; - + @@ -23,7 +23,7 @@ - + From fedora-docs-commits at redhat.com Tue Jun 28 21:49:13 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 17:49:13 -0400 Subject: translation-guide Makefile, 1.2, 1.3 translation-guide-en.xml, 1.5, 1.6 Message-ID: <200506282149.j5SLnDCv018120@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/translation-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18101 Modified Files: Makefile translation-guide-en.xml Log Message: Fixed entity file references and Makefile Index: Makefile =================================================================== RCS file: /cvs/docs/translation-guide/Makefile,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Makefile 5 Feb 2004 00:25:51 -0000 1.2 +++ Makefile 28 Jun 2005 21:49:10 -0000 1.3 @@ -7,18 +7,20 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = translation-guide-en XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf-%: @@ -26,4 +28,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz Index: translation-guide-en.xml =================================================================== RCS file: /cvs/docs/translation-guide/translation-guide-en.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- translation-guide-en.xml 31 Aug 2004 01:21:22 -0000 1.5 +++ translation-guide-en.xml 28 Jun 2005 21:49:10 -0000 1.6 @@ -3,12 +3,12 @@ + %FEDORA-ENTITIES-EN; - + From fedora-docs-commits at redhat.com Tue Jun 28 21:52:47 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 17:52:47 -0400 Subject: translation-guide-windows Makefile, 1.1, 1.2 translate-in-windows-en.xml, 1.2, 1.3 Message-ID: <200506282152.j5SLqlLO018145@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/translation-guide-windows In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv18126 Modified Files: Makefile translate-in-windows-en.xml Log Message: Updated entity file references and Makefile Index: Makefile =================================================================== RCS file: /cvs/docs/translation-guide-windows/Makefile,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- Makefile 23 Sep 2004 02:53:56 -0000 1.1 +++ Makefile 28 Jun 2005 21:52:45 -0000 1.2 @@ -7,18 +7,20 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = translate-in-windows-$(LANG) XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) @cp -r figs/ $(DOCNAME)/ @@ -27,4 +29,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz Index: translate-in-windows-en.xml =================================================================== RCS file: /cvs/docs/translation-guide-windows/translate-in-windows-en.xml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- translate-in-windows-en.xml 7 Oct 2004 14:59:31 -0000 1.2 +++ translate-in-windows-en.xml 28 Jun 2005 21:52:45 -0000 1.3 @@ -1,16 +1,11 @@ - - - - - + +%FEDORA-ENTITIES-EN; - - + ]> From fedora-docs-commits at redhat.com Tue Jun 28 22:14:45 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 18:14:45 -0400 Subject: selinux-apache Makefile,1.1,1.2 selinux-apache-en.xml,1.24,1.25 Message-ID: <200506282214.j5SMEjPW019290@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/selinux-apache In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19271 Modified Files: Makefile selinux-apache-en.xml Log Message: Updated entity file references and Makefile Index: Makefile =================================================================== RCS file: /cvs/docs/selinux-apache/Makefile,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- Makefile 11 Nov 2004 19:13:12 -0000 1.1 +++ Makefile 28 Jun 2005 22:14:42 -0000 1.2 @@ -7,18 +7,20 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = selinux-apache-$(LANG) XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: @@ -26,4 +28,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz Index: selinux-apache-en.xml =================================================================== RCS file: /cvs/docs/selinux-apache/selinux-apache-en.xml,v retrieving revision 1.24 retrieving revision 1.25 diff -u -r1.24 -r1.25 --- selinux-apache-en.xml 18 Nov 2004 19:18:59 -0000 1.24 +++ selinux-apache-en.xml 28 Jun 2005 22:14:42 -0000 1.25 @@ -3,7 +3,7 @@ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ - + %FEDORA-ENTITIES-EN; From fedora-docs-commits at redhat.com Tue Jun 28 22:28:38 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 18:28:38 -0400 Subject: developer-guide developers-guide-en.xml,1.8,1.9 Message-ID: <200506282228.j5SMScTR019355@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/developer-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19338 Modified Files: developers-guide-en.xml Log Message: Updated entity references Index: developers-guide-en.xml =================================================================== RCS file: /cvs/docs/developer-guide/developers-guide-en.xml,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- developers-guide-en.xml 30 Aug 2004 14:03:46 -0000 1.8 +++ developers-guide-en.xml 28 Jun 2005 22:28:35 -0000 1.9 @@ -1,13 +1,13 @@ + %FEDORA-ENTITIES-EN; - - + + ]> From fedora-docs-commits at redhat.com Tue Jun 28 22:28:55 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 18:28:55 -0400 Subject: developer-guide Makefile,1.7,1.8 Message-ID: <200506282228.j5SMStGE019378@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/developer-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19361 Modified Files: Makefile Log Message: Updated Makefile Index: Makefile =================================================================== RCS file: /cvs/docs/developer-guide/Makefile,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- Makefile 21 Nov 2003 22:39:22 -0000 1.7 +++ Makefile 28 Jun 2005 22:28:53 -0000 1.8 @@ -7,22 +7,24 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = developers-guide-$(LANG) XMLFILE = $(DOCNAME).xml - + +###################################################### +include ../docs-common/Makefile.common ###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: @xmlto pdf -x $(XSLPDF) $(XMLFILE) ###################################################### - + clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz From fedora-docs-commits at redhat.com Tue Jun 28 22:30:42 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 18:30:42 -0400 Subject: install-guide Makefile,1.8,1.9 Message-ID: <200506282230.j5SMUgX3019409@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19392 Modified Files: Makefile Log Message: Allow tarball building with Makefile.common Index: Makefile =================================================================== RCS file: /cvs/docs/install-guide/Makefile,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- Makefile 14 Jun 2005 22:36:46 -0000 1.8 +++ Makefile 28 Jun 2005 22:30:40 -0000 1.9 @@ -14,6 +14,8 @@ XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images @@ -28,4 +30,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz From fedora-docs-commits at redhat.com Tue Jun 28 22:33:49 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 18:33:49 -0400 Subject: stateless-linux Makefile, 1.1, 1.2 stateless-linux-HOWTO-en.xml, 1.5, 1.6 Message-ID: <200506282233.j5SMXnhU019442@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/stateless-linux In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19423 Modified Files: Makefile stateless-linux-HOWTO-en.xml Log Message: Updated entity file references, and Makefile for tarball building Index: Makefile =================================================================== RCS file: /cvs/docs/stateless-linux/Makefile,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- Makefile 13 Sep 2004 17:43:08 -0000 1.1 +++ Makefile 28 Jun 2005 22:33:46 -0000 1.2 @@ -7,18 +7,20 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl LANG = en DOCNAME = stateless-linux-HOWTO-$(LANG) XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) + @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + @cp ../docs-common/css/fedora.css $(DOCNAME) pdf: @@ -26,4 +28,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz Index: stateless-linux-HOWTO-en.xml =================================================================== RCS file: /cvs/docs/stateless-linux/stateless-linux-HOWTO-en.xml,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- stateless-linux-HOWTO-en.xml 30 Sep 2004 20:18:01 -0000 1.5 +++ stateless-linux-HOWTO-en.xml 28 Jun 2005 22:33:46 -0000 1.6 @@ -25,12 +25,12 @@ - + %FEDORA-ENTITIES-EN; - + ] >
From fedora-docs-commits at redhat.com Tue Jun 28 22:34:58 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Tue, 28 Jun 2005 18:34:58 -0400 Subject: mirror-tutorial Makefile,1.2,1.3 Message-ID: <200506282234.j5SMYw1d019475@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/mirror-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19458 Modified Files: Makefile Log Message: Updated Makefile to allow tarball building Index: Makefile =================================================================== RCS file: /cvs/docs/mirror-tutorial/Makefile,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Makefile 18 Jun 2005 13:51:02 -0000 1.2 +++ Makefile 28 Jun 2005 22:34:56 -0000 1.3 @@ -14,6 +14,8 @@ XMLFILE = $(DOCNAME).xml ###################################################### +include ../docs-common/Makefile.common +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images @@ -26,4 +28,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz From fedora-docs-commits at redhat.com Wed Jun 29 00:41:25 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Tue, 28 Jun 2005 20:41:25 -0400 Subject: yum-software-management Makefile,1.2,1.3 Message-ID: <200506290041.j5T0fPNS021912@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/yum-software-management In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv21895 Modified Files: Makefile Log Message: Updated for tar.gz generation. Index: Makefile =================================================================== RCS file: /cvs/docs/yum-software-management/Makefile,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Makefile 14 Jun 2005 22:45:38 -0000 1.2 +++ Makefile 29 Jun 2005 00:41:23 -0000 1.3 @@ -1,7 +1,7 @@ ############################################################################### # Makefile for RHLP docs project # Created by: Tammy Fox -# Last edited by: Tammy Fox +# Last edited by: Stuart Ellis # WARNING: need passivetex 1.24 for pdf generation to work # License: GPL # Copyright 2003 Tammy Fox, Red Hat, Inc. @@ -12,7 +12,8 @@ LANG = en DOCNAME = yum-software-management-$(LANG) XMLFILE = $(DOCNAME).xml - +###################################################### +include ../docs-common/Makefile.common ###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @@ -26,4 +27,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz From fedora-docs-commits at redhat.com Wed Jun 29 00:45:24 2005 From: fedora-docs-commits at redhat.com (Stuart Ellis (elliss)) Date: Tue, 28 Jun 2005 20:45:24 -0400 Subject: desktop-up2date Makefile,1.2,1.3 Message-ID: <200506290045.j5T0jO9b021937@cvs-int.fedora.redhat.com> Author: elliss Update of /cvs/docs/desktop-up2date In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv21920 Modified Files: Makefile Log Message: Updated for .tar.gz generation Index: Makefile =================================================================== RCS file: /cvs/docs/desktop-up2date/Makefile,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Makefile 14 Jun 2005 22:30:42 -0000 1.2 +++ Makefile 29 Jun 2005 00:45:22 -0000 1.3 @@ -1,7 +1,7 @@ ############################################################################### # Makefile for RHLP docs project # Created by: Tammy Fox -# Last edited by: Tammy Fox +# Last edited by: Stuart Ellis # WARNING: need passivetex 1.24 for pdf generation to work # License: GPL # Copyright 2003 Tammy Fox, Red Hat, Inc. @@ -14,6 +14,10 @@ XMLFILE = $(DOCNAME).xml ###################################################### + +include ../docs-common/Makefile.common + +###################################################### html: @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) @mkdir -p $(DOCNAME)/stylesheet-images @@ -26,4 +30,4 @@ ###################################################### clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) + @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz From fedora-docs-commits at redhat.com Wed Jun 29 02:16:48 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 28 Jun 2005 22:16:48 -0400 Subject: example-tutorial Makefile,1.8,1.9 Message-ID: <200506290216.j5T2Gm3b024311@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv24282/example-tutorial Modified Files: Makefile Log Message: Move _ALL_ default targets and rules into "Makefile.common" as double-colon targets, so they can be appended-to by a document without needing to rewrite "Makefile.common". Index: Makefile =================================================================== RCS file: /cvs/docs/example-tutorial/Makefile,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- Makefile 28 Jun 2005 21:25:16 -0000 1.8 +++ Makefile 29 Jun 2005 02:16:46 -0000 1.9 @@ -1,31 +1,29 @@ ############################################################################### # Makefile for RHLP docs project # Created by: Tammy Fox -# Last edited by: Tammy Fox +# Last edited by: Tommy Reynolds # 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 ############################################################################### -XSLPDF = ../docs-common/xsl/main-pdf.xsl -XSLHTML = ../docs-common/xsl/main-html.xsl -LANG = en -DOCNAME = example-tutorial-$(LANG) -XMLFILE = $(DOCNAME).xml +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl +LANG = en +DOCNAME = example-tutorial-$(LANG) +XMLFILE = $(DOCNAME).xml +XMLEXTRAFILES = ###################################################### include ../docs-common/Makefile.common ###################################################### -html: - @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) - @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../docs-common/css/fedora.css $(DOCNAME) - -pdf: - @xmlto pdf -x $(XSLPDF) $(XMLFILE) -###################################################### - -clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) +# 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: +#${DOCNAME}/index.html:: +# echo FINISHED AT LAST From fedora-docs-commits at redhat.com Wed Jun 29 02:16:49 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Tue, 28 Jun 2005 22:16:49 -0400 Subject: docs-common Makefile.common,1.2,1.3 Message-ID: <200506290216.j5T2Gnjt024317@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv24282/docs-common Modified Files: Makefile.common Log Message: Move _ALL_ default targets and rules into "Makefile.common" as double-colon targets, so they can be appended-to by a document without needing to rewrite "Makefile.common". Index: Makefile.common =================================================================== RCS file: /cvs/docs/docs-common/Makefile.common,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Makefile.common 28 Jun 2005 21:25:17 -0000 1.2 +++ Makefile.common 29 Jun 2005 02:16:46 -0000 1.3 @@ -1,2 +1,51 @@ -tarball ${DOCNAME}.tar.gz: html +######################################################################### +# Makefile.common +# +# This file, to be included from every document's local Makefile, provides +# the basic targets used by the Fedora Docs Project: +# all -- Default target, builds HTML document only +# ${DOCNAME}/index.html -- Builds HTML version of document +# html -- See "${DOCNAME}/index.html" +# ${DOCNAME}.tar.gz -- Packages HTML document into a tar archive +# tarball -- See "${DOCNAME}.tar.gz" +# clean -- Deletes all generated files and directories +# distclean -- See "clean" +# ${DOCNAME}.pdf -- Builds PDF version of document +# pdf -- See "${DOCNAME}.pdf" +######################################################################### +# PDF generation is still fragile and probably won't work on your document +######################################################################### +# Note: all targets within this Makefile.common must be defined as +# double-colon (::) targets so that additional steps can be added by +# providing additional rules, also marked with double-colons, in the +# document Makefile. +######################################################################### +# PUT NO TARGETS BEFORE THIS ONE, not even in your base Makefile +# In a properly-constructed Makefile, this will be the default target + +all:: ${DOCNAME}/index.html + +# The "tarball" or "${DOCNAME}.tar.gz" target will bind the HTML formatted +# document into a compressed tar archive. + +tarball ${DOCNAME}.tar.gz:: html tar -zcf ${DOCNAME}.tar.gz ${DOCNAME} + +# The "pdf" or "${DOCNAME}.pdf" target produces an Adobe Portable Document +# Format (PDF) file as output. + +pdf ${DOCNAME}.pdf:: ${XMLFILE} ${XMLEXTRAFILES} + xmlto pdf -x $(XSLPDF) $(XMLFILE) + +# The "html" or "${DOCNAME}. +html ${DOCNAME}/index.html:: ${XMLFILE} ${XMLEXTRAFILES} + xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) + mkdir -p $(DOCNAME)/stylesheet-images + cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images + cp ../docs-common/css/fedora.css $(DOCNAME) + +# The "clean" or "distclean" target will remove all generated and temporary +# files. + +distclean clean: + ${RM} -r ${DOCNAME}.pdf $(DOCNAME) ${DOCNAME}.tar.gz From fedora-docs-commits at redhat.com Wed Jun 29 12:57:43 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 08:57:43 -0400 Subject: mirror-tutorial Makefile,1.3,1.4 Message-ID: <200506291257.j5TCvhZg006106@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/mirror-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv6089 Modified Files: Makefile Log Message: Subscribe to new Makefile.common functionality Index: Makefile =================================================================== RCS file: /cvs/docs/mirror-tutorial/Makefile,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- Makefile 28 Jun 2005 22:34:56 -0000 1.3 +++ Makefile 29 Jun 2005 12:57:41 -0000 1.4 @@ -1,31 +1,29 @@ ############################################################################### # Makefile for RHLP docs project # Created by: Tammy Fox -# Last edited by: Tammy Fox +# Last edited by: Tommy Reynolds # 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 ############################################################################### -XSLPDF = ../docs-common/xsl/main-pdf.xsl -XSLHTML = ../docs-common/xsl/main-html.xsl -LANG = en -DOCNAME = mirror-tutorial-$(LANG) -XMLFILE = $(DOCNAME).xml +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl +LANG = en +DOCNAME = mirror-tutorial-$(LANG) +XMLFILE = $(DOCNAME).xml +XMLEXTRAFILES = ###################################################### include ../docs-common/Makefile.common ###################################################### -html: - @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) - @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../docs-common/css/fedora.css $(DOCNAME) - -pdf-%: - @xmlto pdf -x $(XSLPDF) $(XMLFILE) -###################################################### - -clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz +# 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: +#${DOCNAME}/index.html:: +# echo FINISHED AT LAST From fedora-docs-commits at redhat.com Wed Jun 29 13:02:47 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 09:02:47 -0400 Subject: documentation-guide Makefile,1.6,1.7 Message-ID: <200506291302.j5TD2lBX007177@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/documentation-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv7160 Modified Files: Makefile Log Message: Subscribe to new Makefile.common functions Index: Makefile =================================================================== RCS file: /cvs/docs/documentation-guide/Makefile,v retrieving revision 1.6 retrieving revision 1.7 diff -u -r1.6 -r1.7 --- Makefile 28 Jun 2005 21:46:45 -0000 1.6 +++ Makefile 29 Jun 2005 13:02:27 -0000 1.7 @@ -16,16 +16,3 @@ ###################################################### include ../docs-common/Makefile.common ###################################################### -html: - @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) - @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../docs-common/css/fedora.css $(DOCNAME) - - -pdf: - @xmlto pdf -x $(XSLPDF) $(XMLFILE) -###################################################### - -clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz From fedora-docs-commits at redhat.com Wed Jun 29 14:16:13 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 10:16:13 -0400 Subject: docs-common Makefile.common,1.3,1.4 Message-ID: <200506291416.j5TEGDgH008618@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv8601 Modified Files: Makefile.common Log Message: Added html-nochunks target Index: Makefile.common =================================================================== RCS file: /cvs/docs/docs-common/Makefile.common,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- Makefile.common 29 Jun 2005 02:16:46 -0000 1.3 +++ Makefile.common 29 Jun 2005 14:16:11 -0000 1.4 @@ -6,6 +6,7 @@ # all -- Default target, builds HTML document only # ${DOCNAME}/index.html -- Builds HTML version of document # html -- See "${DOCNAME}/index.html" +# html-nochunks -- See "${DOCNAME}.html"; single HTML file # ${DOCNAME}.tar.gz -- Packages HTML document into a tar archive # tarball -- See "${DOCNAME}.tar.gz" # clean -- Deletes all generated files and directories @@ -44,8 +45,11 @@ cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images cp ../docs-common/css/fedora.css $(DOCNAME) +html-nochunks $(DOCNAME).html:: ${XMLFILE} ${XMLEXTRAFILES} + xmlto html-nochunks -x $(XSLHTMLNOCHUNKS) $(XMLFILE) + # The "clean" or "distclean" target will remove all generated and temporary # files. distclean clean: - ${RM} -r ${DOCNAME}.pdf $(DOCNAME) ${DOCNAME}.tar.gz + ${RM} -r ${DOCNAME}.pdf $(DOCNAME) ${DOCNAME}.tar.gz ${DOCNAME}.html From fedora-docs-commits at redhat.com Wed Jun 29 14:17:04 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 10:17:04 -0400 Subject: example-tutorial Makefile,1.9,1.10 Message-ID: <200506291417.j5TEH4qN008641@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/example-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv8624 Modified Files: Makefile Log Message: Added support for html-nochunks Index: Makefile =================================================================== RCS file: /cvs/docs/example-tutorial/Makefile,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- Makefile 29 Jun 2005 02:16:46 -0000 1.9 +++ Makefile 29 Jun 2005 14:17:01 -0000 1.10 @@ -10,6 +10,7 @@ XSLPDF = ../docs-common/xsl/main-pdf.xsl XSLHTML = ../docs-common/xsl/main-html.xsl +XSLHTMLNOCHUNKS = ../docs-common/xsl/main-html-nochunks.xsl LANG = en DOCNAME = example-tutorial-$(LANG) XMLFILE = $(DOCNAME).xml From fedora-docs-commits at redhat.com Wed Jun 29 14:31:28 2005 From: fedora-docs-commits at redhat.com (Tommy Reynolds (jtr)) Date: Wed, 29 Jun 2005 10:31:28 -0400 Subject: docs-common Makefile.common,1.4,1.5 Message-ID: <200506291431.j5TEVS9x008723@cvs-int.fedora.redhat.com> Author: jtr Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv8706 Modified Files: Makefile.common Log Message: 1) Added proper ".PHONY" declaration for pseudo-targets like "html" and "pdf". 2) Changed tarball dependancy from "html" to the "${DOCNAME}/index.html" target to avoid unnecessary rebuilds. Index: Makefile.common =================================================================== RCS file: /cvs/docs/docs-common/Makefile.common,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- Makefile.common 29 Jun 2005 14:16:11 -0000 1.4 +++ Makefile.common 29 Jun 2005 14:31:26 -0000 1.5 @@ -24,12 +24,14 @@ # PUT NO TARGETS BEFORE THIS ONE, not even in your base Makefile # In a properly-constructed Makefile, this will be the default target +.PHONY: all tarball pdf html html-nochunks clean distclean + all:: ${DOCNAME}/index.html # The "tarball" or "${DOCNAME}.tar.gz" target will bind the HTML formatted # document into a compressed tar archive. -tarball ${DOCNAME}.tar.gz:: html +tarball ${DOCNAME}.tar.gz:: ${DOCNAME}/index.html tar -zcf ${DOCNAME}.tar.gz ${DOCNAME} # The "pdf" or "${DOCNAME}.pdf" target produces an Adobe Portable Document From fedora-docs-commits at redhat.com Wed Jun 29 14:32:52 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 10:32:52 -0400 Subject: docs-common/xsl html-common.xsl, 1.8, 1.9 main-html-nochunks.xsl, 1.1, 1.2 main-html.xsl, 1.4, 1.5 Message-ID: <200506291432.j5TEWqB9008760@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/docs-common/xsl In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv8739 Modified Files: html-common.xsl main-html-nochunks.xsl main-html.xsl Log Message: Fix legalnotice linkage to embed in nochunks version only Index: html-common.xsl =================================================================== RCS file: /cvs/docs/docs-common/xsl/html-common.xsl,v retrieving revision 1.8 retrieving revision 1.9 diff -u -r1.8 -r1.9 --- html-common.xsl 2 Jun 2005 18:23:16 -0000 1.8 +++ html-common.xsl 29 Jun 2005 14:32:49 -0000 1.9 @@ -25,8 +25,6 @@ - - text/css Index: main-html-nochunks.xsl =================================================================== RCS file: /cvs/docs/docs-common/xsl/main-html-nochunks.xsl,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- main-html-nochunks.xsl 30 May 2005 19:23:12 -0000 1.1 +++ main-html-nochunks.xsl 29 Jun 2005 14:32:49 -0000 1.2 @@ -44,4 +44,7 @@ encoding="UTF-8" indent="yes"/> + + + Index: main-html.xsl =================================================================== RCS file: /cvs/docs/docs-common/xsl/main-html.xsl,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- main-html.xsl 2 Jun 2005 17:57:59 -0000 1.4 +++ main-html.xsl 29 Jun 2005 14:32:49 -0000 1.5 @@ -21,6 +21,8 @@ + + book toc article toc From fedora-docs-commits at redhat.com Wed Jun 29 14:34:40 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 10:34:40 -0400 Subject: mirror-tutorial Makefile,1.4,1.5 Message-ID: <200506291434.j5TEYeri008788@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/mirror-tutorial In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv8771 Modified Files: Makefile Log Message: Add nochunks XSL declaration Index: Makefile =================================================================== RCS file: /cvs/docs/mirror-tutorial/Makefile,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- Makefile 29 Jun 2005 12:57:41 -0000 1.4 +++ Makefile 29 Jun 2005 14:34:37 -0000 1.5 @@ -10,6 +10,7 @@ XSLPDF = ../docs-common/xsl/main-pdf.xsl XSLHTML = ../docs-common/xsl/main-html.xsl +XSLHTMLNOCHUNKS = ../docs-common/xsl/main-html-nochunks.xsl LANG = en DOCNAME = mirror-tutorial-$(LANG) XMLFILE = $(DOCNAME).xml From fedora-docs-commits at redhat.com Wed Jun 29 14:41:40 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 10:41:40 -0400 Subject: docs-common Makefile.common,1.5,1.6 Message-ID: <200506291441.j5TEfeTQ008879@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/docs-common In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv8862 Modified Files: Makefile.common Log Message: Get the images and CSS, remember to clean it up too Index: Makefile.common =================================================================== RCS file: /cvs/docs/docs-common/Makefile.common,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- Makefile.common 29 Jun 2005 14:31:26 -0000 1.5 +++ Makefile.common 29 Jun 2005 14:41:37 -0000 1.6 @@ -49,9 +49,14 @@ html-nochunks $(DOCNAME).html:: ${XMLFILE} ${XMLEXTRAFILES} xmlto html-nochunks -x $(XSLHTMLNOCHUNKS) $(XMLFILE) + mkdir -p stylesheet-images + cp ../docs-common/stylesheet-images/*.png stylesheet-images + cp ../docs-common/css/fedora.css . # The "clean" or "distclean" target will remove all generated and temporary # files. distclean clean: - ${RM} -r ${DOCNAME}.pdf $(DOCNAME) ${DOCNAME}.tar.gz ${DOCNAME}.html + ${RM} -r ${DOCNAME}.pdf $(DOCNAME) \ + ${DOCNAME}.tar.gz \ + ${DOCNAME}.html stylesheet-images fedora.css From fedora-docs-commits at redhat.com Wed Jun 29 14:45:46 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 10:45:46 -0400 Subject: documentation-guide Makefile,1.7,1.8 Message-ID: <200506291445.j5TEjkex008943@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/documentation-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv8926 Modified Files: Makefile Log Message: Add XSL declaration to support nochunks Index: Makefile =================================================================== RCS file: /cvs/docs/documentation-guide/Makefile,v retrieving revision 1.7 retrieving revision 1.8 diff -u -r1.7 -r1.8 --- Makefile 29 Jun 2005 13:02:27 -0000 1.7 +++ Makefile 29 Jun 2005 14:45:43 -0000 1.8 @@ -7,11 +7,12 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### -XSLPDF = ../docs-common/xsl/main-pdf.xsl -XSLHTML = ../docs-common/xsl/main-html.xsl -LANG = en -DOCNAME = documentation-guide-$(LANG) -XMLFILE = $(DOCNAME).xml +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl +XSLHTMLNOCHUNKS = ../docs-common/xsl/main-html-nochunks.xsl +LANG = en +DOCNAME = documentation-guide-$(LANG) +XMLFILE = $(DOCNAME).xml ###################################################### include ../docs-common/Makefile.common From fedora-docs-commits at redhat.com Wed Jun 29 14:51:06 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Wed, 29 Jun 2005 10:51:06 -0400 Subject: selinux-faq selinux-faq-en.xml,1.24,1.25 Message-ID: <200506291451.j5TEp6xm009046@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/selinux-faq In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv9029 Modified Files: selinux-faq-en.xml Log Message: Use updated entities file declaration Add &APACHE; entity locally so make works Index: selinux-faq-en.xml =================================================================== RCS file: /cvs/docs/selinux-faq/selinux-faq-en.xml,v retrieving revision 1.24 retrieving revision 1.25 diff -u -r1.24 -r1.25 --- selinux-faq-en.xml 6 Feb 2005 21:27:26 -0000 1.24 +++ selinux-faq-en.xml 29 Jun 2005 14:51:04 -0000 1.25 @@ -3,12 +3,13 @@ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ - + %FEDORA-ENTITIES-EN; + Author: pfrields Update of /cvs/docs/selinux-faq In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv9059 Modified Files: Makefile Log Message: Support nochunks, and remove redundant common targets Index: Makefile =================================================================== RCS file: /cvs/docs/selinux-faq/Makefile,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- Makefile 10 May 2005 19:54:57 -0000 1.2 +++ Makefile 29 Jun 2005 14:51:37 -0000 1.3 @@ -7,23 +7,13 @@ # Copyright 2003 Tammy Fox, Red Hat, Inc. ############################################################################### # test commit -XSLPDF = ../xsl/main-pdf.xsl -XSLHTML = ../xsl/main-html.xsl +XSLPDF = ../docs-common/xsl/main-pdf.xsl +XSLHTML = ../docs-common/xsl/main-html.xsl +XSLHTMLNOCHUNKS= ../docs-common/xsl/main-html-nochunks.xsl LANG = en DOCNAME = selinux-faq-$(LANG) XMLFILE = $(DOCNAME).xml ###################################################### -html: - @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) - @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @cp ../css/fedora.css $(DOCNAME) - - -pdf: - @xmlto pdf -x $(XSLPDF) $(XMLFILE) +include ../docs-common/Makefile.common ###################################################### - -clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) From fedora-docs-commits at redhat.com Thu Jun 30 15:19:42 2005 From: fedora-docs-commits at redhat.com (Paul W. Frields (pfrields)) Date: Thu, 30 Jun 2005 11:19:42 -0400 Subject: install-guide Makefile, 1.9, 1.10 fedora-install-guide-upgrading-en.xml, 1.10, 1.11 Message-ID: <200506301519.j5UFJgmR011282@cvs-int.fedora.redhat.com> Author: pfrields Update of /cvs/docs/install-guide In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv11263 Modified Files: Makefile fedora-install-guide-upgrading-en.xml Log Message: Use new Makefile.common rules and add nochunks capability Fix id attributes in upgrading chapter Index: Makefile =================================================================== RCS file: /cvs/docs/install-guide/Makefile,v retrieving revision 1.9 retrieving revision 1.10 diff -u -r1.9 -r1.10 --- Makefile 28 Jun 2005 22:30:40 -0000 1.9 +++ Makefile 30 Jun 2005 15:19:40 -0000 1.10 @@ -9,6 +9,7 @@ XSLPDF = ../docs-common/xsl/main-pdf.xsl XSLHTML = ../docs-common/xsl/main-html.xsl +XSLHTMLNOCHUNKS = ../docs-common/xsl/main-html-nochunks.xsl LANG = en DOCNAME = fedora-install-guide-$(LANG) XMLFILE = $(DOCNAME).xml @@ -16,18 +17,6 @@ ###################################################### include ../docs-common/Makefile.common ###################################################### -html: - @xmlto html -x $(XSLHTML) -o $(DOCNAME) $(XMLFILE) - @mkdir -p $(DOCNAME)/stylesheet-images - @cp ../docs-common/stylesheet-images/*.png $(DOCNAME)/stylesheet-images - @mkdir -p $(DOCNAME)/figs - @cp figs/*.png figs/*.eps $(DOCNAME)/figs - @cp ../docs-common/css/fedora.css $(DOCNAME) - - -pdf: - @xmlto pdf -x $(XSLPDF) $(XMLFILE) -###################################################### - -clean: - @rm -rfv *.html *.pdf *.tex $(DOCNAME) $(DOCNAME).tar.gz +$(DOCNAME)/index.html:: + mkdir -p $(DOCNAME)/figs + cp figs/*.png figs/*.eps $(DOCNAME)/figs Index: fedora-install-guide-upgrading-en.xml =================================================================== RCS file: /cvs/docs/install-guide/fedora-install-guide-upgrading-en.xml,v retrieving revision 1.10 retrieving revision 1.11 diff -u -r1.10 -r1.11 --- fedora-install-guide-upgrading-en.xml 27 May 2005 22:15:15 -0000 1.10 +++ fedora-install-guide-upgrading-en.xml 30 Jun 2005 15:19:40 -0000 1.11 @@ -1,6 +1,6 @@ - + Upgrading an Existing System @@ -57,7 +57,7 @@
-
+
Upgrading Boot Loader Configuration