Author: pfrields
Update of /cvs/docs/documentation-guide
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv19280
Modified Files:
docs-getting-files-en.xml
Log Message:
Clean up CVS instructions a bit, removing excess tagging in screens, some style changes
Index: docs-getting-files-en.xml
===================================================================
RCS file: /cvs/docs/documentation-guide/docs-getting-files-en.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- docs-getting-files-en.xml 14 May 2005 20:00:15 -0000 1.3
+++ docs-getting-files-en.xml 24 Aug 2005 12:30:26 -0000 1.4
@@ -32,34 +32,31 @@
<para>
The custom scripts and stylesheets used are all stored in CVS on the
<computeroutput>cvs.fedora.redhat.com</computeroutput> CVS server.
- </para>
-
- <para>
You need to check them out along with the DocBook XML files for the
existing docs.
</para>
<para>
- Get started by following these once-only steps.
- When asked for a <abbrev>CVS</abbrev> password, just press the
<guibutton>ENTER</guibutton> key.
+ You should perform these steps only once, when you first make a checkout
+ from docs CVS. When you see the password prompt, just press the
+ <keycap>Enter</keycap> key.
</para>
<screen>
-<prompt>$ </prompt><command>mkdir my-fedora-docs</command>
-<prompt>$ </prompt><command>cd my-fedora-docs</command>
-<prompt>$ </prompt><command>export
CVSROOT=:pserver:anonymous@cvs.fedora.redhat.com:/cvs/docs</command>
-<prompt>$ </prompt><command>cvs login</command>
-<enter>
-<prompt>$ </prompt><command>cvs co docs-setup</command>
+<userinput>mkdir my-fedora-docs
+cd my-fedora-docs
+export CVSROOT=:pserver:anonymous@cvs.fedora.redhat.com:/cvs/docs
+cvs login
+cvs co docs-setup</userinput>
</screen>
<para>
- Checking the files out anonymously means that you can view them and
- retreive the latest versions, but you can not add (commit) any updates or
- new files back to the repository.
- You need <abbrev>CVS</abbrev> write access for that; check with the
- <ulink
url="http://fedoraproject.org/wiki/DocsProject/NewWriters">&...
- site to learn about getting write access to <abbrev>CVS</abbrev>.
+ When you perform an anonymous CVS checkout, you can view the files and
+ retreive the latest versions. You can not add (commit) any updates or new
+ files back to the repository. To commit changes to CVS, you must have
+ <abbrev>CVS</abbrev> write access. Refer to <ulink
+
url="http://fedoraproject.org/wiki/DocsProject/NewWriters"/> to learn
+ about getting write access to <abbrev>CVS</abbrev>.
</para>
<para>
@@ -72,12 +69,12 @@
Pick your document of interest and then download it to your working directory:
</para>
-<screen><prompt>$ </prompt><command>cvs co
example-tutorial</command></screen>
+<screen><userinput>cvs co example-tutorial</userinput></screen>
<para>
- Except for the <citetitle>&IG;</citetitle>, all docs must be
tutorials
- written in DocBook XML article format using the template in the
- <filename>example-tutorial</filename> directory. Each tutorial
+ Except for the <citetitle>&IG;</citetitle>, all documentation in
CVS must
+ be tutorials written in DocBook XML article format using the template in
+ the <filename>example-tutorial</filename> directory. Each tutorial
<emphasis>must</emphasis> be in its own directory. No XML files should
be
in the root directory.
</para>