Uploaded image for project: 'Subversion'
  1. Subversion
  2. SVN-1189

Add <command> tags around svn commands in ch08.xml

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Major
    • Resolution: Fixed
    • all
    • unscheduled
    • docs
    • None

    Description

      Patch by Larry Shatzer. For some reason not in the archives. Copying message here:
      
      Looking over the list of subcommands, I noticed a few spots where "svn 
      <command>" was not bold. In this case, not wrapped in a <command> tag. I tried 
      to wrap the text best I could, so we didn't get any long lines. Feel free to fix 
      it where needed.
      
      Log Message: Add <command> tags around svn commands.
      
      Index: doc/book/book/ch08.xml
      ===================================================================
      --- doc/book/book/ch08.xml	(revision 5098)
      +++ doc/book/book/ch08.xml	(working copy)
      @@ -393,7 +393,7 @@
                   </screen>
       
                   <para>When adding a directory, the default behavior of
      -              svn add is to recurse:</para>
      +              <command>svn add</command> is to recurse:</para>
                   
                   <screen>
         $ svn add testdir
      @@ -428,7 +428,8 @@
                   <title>Description</title>
                   
                   <para>Outputs the contents of the specified files or URLs.
      -              For listing the contents of directories, see svn list.</para>
      +              For listing the contents of directories, see <command>svn
      +              list</command>.</para>
                 </refsect1>
       
                 <refsect1>
      @@ -631,8 +632,8 @@
                 <refsect1>
                   <title>Examples</title>
       
      -            <para>Well, there's not much to the examples here as svn
      -              cleanup generates no output.  If you pass no PATH, '.'
      +            <para>Well, there's not much to the examples here as <command>svn
      +              cleanup</command> generates no output.  If you pass no PATH, '.'
                     is used.</para>
       
                   <screen>
      @@ -888,8 +889,8 @@
       
                   <tip>
                     <para>This is the easiest way to 'tag' a revision in
      -                your repository&mdash;just svn copy that revision
      -                (usually HEAD) into your tags directory.</para>
      +                your repository&mdash;just <command>svn copy</command>
      +                that revision (usually HEAD) into your tags directory.</para>
                   </tip>
       
                   <screen>
      @@ -1103,7 +1104,7 @@
                   <title>Examples</title>
       
                   <para>Compare BASE and your working copy (One of the most
      -              popular uses of svn diff):</para>
      +              popular uses of <command>svn diff</command>):</para>
       
                   <screen>
       $ svn diff COMMITTERS 
      @@ -1633,8 +1634,8 @@
                   <title>Examples</title>
       
                   <para>You can see the log messages for all the paths that
      -              changed in your working copy by running svn log from the
      -              top:</para>
      +              changed in your working copy by running <command>svn
      +              log</command> from the top:</para>
       
                   <screen>
       $ svn log
      @@ -1771,8 +1772,9 @@
       
       
                   <warning>
      -              <para>If you run svn log on a specific path and provide
      -                a specific revision and get no output at all</para>
      +              <para>If you run <command>svn log</command> on a specific
      +                path and provide a specific revision and get no output
      +                at all</para>
       
                     <screen>
       $ svn log -r 20 http://svn.red-bean.com/untouched.txt
      @@ -2544,10 +2546,11 @@
                   </screen>
       
                   <warning>
      -              <para>If you provide no targets to svn revert, it will
      -                do nothing&mdash;to protect you from accidentally
      -                losing changes in your working copy, svn revert
      -                requires you to provide at least one target.</para>
      +              <para>If you provide no targets to <command>svn
      +                revert</command>, it will do nothing&mdash;to protect
      +                you from accidentally losing changes in your working
      +                copy, <command>svn revert</command> requires you to
      +                provide at least one target.</para>
                   </warning>
       
                 </refsect1>
      @@ -2625,11 +2628,11 @@
       
                   <warning>
                     <para>You <emphasis>can</emphasis> just remove the
      -                conflict files and commit, but svn resolve fixes up
      -                some bookkeeping data in the working copy
      -                administrative area in addition to removing the
      -                conflict files, so we recommend that you use this
      -                command.</para>
      +                conflict files and commit, but <command>svn
      +                resolve</command> fixes up some bookkeeping data
      +                in the working copy administrative area in addition
      +                to removing the conflict files, so we recommend that
      +                you use this command.</para>
                   </warning>
       
                 </refsect1>
      @@ -2931,8 +2934,8 @@
       Head revision:   981
                   </screen>
       
      -            <para>For many more examples of svn status, see <xref
      -                linkend="svn-ch-3-sect-4.3.1"/>.</para>
      +            <para>For many more examples of <command>svn status</command>,
      +              see <xref linkend="svn-ch-3-sect-4.3.1"/>.</para>
       
                 </refsect1>
               </refentry>
      @@ -3686,8 +3689,9 @@
               holds the repository, it takes paths as targets and not
               URLs.</para>
       
      -      <para>If no revision or transaction is specified, svnlook defaults
      -        to the youngest (most recent) revision of the repository.</para>
      +      <para>If no revision or transaction is specified,
      +        <command>svnlook</command> defaults to the youngest (most
      +        recent) revision of the repository.</para>
             
             <sect2 id="svn-ch-8-sect-3.1">
               <title>Switches</title>
      @@ -3704,11 +3708,11 @@
                 <varlistentry>
                   <term><option>--no-diff-deleted</option></term>
                   <listitem>
      -              <para>Prevents svnlook from printing differences for
      -                deleted files.  The default behavior when a file is
      -                deleted in a transaction/revision is to print the same
      -                differences that you would see if you had left the
      -                file but removed all the content.</para>
      +              <para>Prevents <command>svnlook</command> from printing
      +                differences for deleted files.  The default behavior
      +                when a file is deleted in a transaction/revision is
      +                to print the same differences that you would see if
      +                you had left the file but removed all the content.</para>
                   </listitem>
                 </varlistentry>
      

      Original issue reported by sander

      Attachments

        Activity

          People

            Unassigned Unassigned
            subversion-importer Subversion Importer
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: