[svnbook commit] r2805 - in trunk/src/nb: . book

sunny256 noreply at red-bean.com
Thu Jun 14 09:09:41 CDT 2007


Author: sunny256
Date: Thu Jun 14 09:09:41 2007
New Revision: 2805

Log:
Sync the Norwegian and English book up to r2606.

* src/nb/book/ch-advanced-topics.xml
* src/nb/book/ch-basic-usage.xml
  Merged and updated r2606. Phew, this one wasn’t easy to cope with.

* src/nb/TRANSLATION-STATUS
* src/nb/LAST_SYNC
  Automatically updated.


Modified:
   trunk/src/nb/LAST_SYNC
   trunk/src/nb/TRANSLATION-STATUS
   trunk/src/nb/book/ch-advanced-topics.xml
   trunk/src/nb/book/ch-basic-usage.xml

Modified: trunk/src/nb/LAST_SYNC
==============================================================================
--- trunk/src/nb/LAST_SYNC	(original)
+++ trunk/src/nb/LAST_SYNC	Thu Jun 14 09:09:41 2007
@@ -1 +1 @@
-2605
+2606

Modified: trunk/src/nb/TRANSLATION-STATUS
==============================================================================
--- trunk/src/nb/TRANSLATION-STATUS	(original)
+++ trunk/src/nb/TRANSLATION-STATUS	Thu Jun 14 09:09:41 2007
@@ -16,10 +16,10 @@
 * book/ch-fundamental-concepts.xml
     Untranslated: 0.90% - 21 lines in 2 blocks
 * book/ch-basic-usage.xml
-    Untranslated: 1.31% - 65 lines in 6 blocks
+    Untranslated: 4.31% - 108 lines in 8 blocks
 * book/ch-advanced-topics.xml
-    Untranslated: 79.25% - 2029 lines in 5 blocks
-    Need proofreading: 21.06% - 575 lines in 2 blocks
+    Untranslated: 76.16% - 2085 lines in 9 blocks
+    Need proofreading: 19.59% - 575 lines in 2 blocks
 * book/ch-branching-and-merging.xml
     Untranslated: 5.06% - 125 lines in 1 block
     Need proofreading: 10.22% - 242 lines in 1 block
@@ -49,4 +49,4 @@
 * book/index.xml
     Translation complete
 
-Summa summarum: 58.85% translated, 17.20% need proofreading
+Summa summarum: 58.43% translated, 17.15% need proofreading

Modified: trunk/src/nb/book/ch-advanced-topics.xml
==============================================================================
--- trunk/src/nb/book/ch-advanced-topics.xml	(original)
+++ trunk/src/nb/book/ch-advanced-topics.xml	Thu Jun 14 09:09:41 2007
@@ -70,8 +70,389 @@
   <!-- ================================================================= -->
   <!-- ================================================================= -->
   <!-- ================================================================= -->
+  <sect1 id="svn.tour.revs.specifiers">
 <!-- @TR {{ -->
+    <title>Revision Specifiers</title>
+
+    <para>As we saw in <xref linkend="svn.tour.revs" />, revision
+      numbers in Subversion are pretty straightforward—integers
+      that keep getting larger as you commit more changes to your
+      versioned data.  Still, it doesn't take long before you can no
+      longer remember exactly what happened in each and every
+      revision.  Fortunately, the typical Subversion workflow doesn't
+      often demand that you supply arbitrary revisions to the
+      Subversion operations you perform.  For operations that
+      <emphasis>do</emphasis> require a revision specifier, you
+      generally supply a revision number that you saw in a commit
+      email, in the output of some other Subversion operation, or in
+      some other context that would yield meaning to that particular
+      number.</para>
+
+    <para>But occasionally, you need to pinpoint a moment in time for
+      which you don't already have a revision number memorized or
+      handy.  So besides the integer revision numbers,
+      <command>svn</command> allows as input some additional forms of
+      revision specifiers—revision keywords, and revision
+      dates.</para>
+
+    <note>
+      <para>The various forms of Subversion revision specifiers can be
+        mixed and matched when used to specify revision ranges.  For
+        example, you can use <option>-r
+        <replaceable>REV1</replaceable>:<replaceable>REV2</replaceable></option>
+        where <replaceable>REV1</replaceable> is a revision keyword
+        and <replaceable>REV2</replaceable> is a revision number, or
+        where <replaceable>REV1</replaceable> is a date and
+        <replaceable>REV2</replaceable> is a revision keyword, and so
+        on.  The individual revision specifiers are independently
+        evaluated, so you can put whatever you want on the opposite
+        sides of that colon.</para>
+    </note>
+<!-- @TR }} -->
+    
+    <!-- =============================================================== -->
+    <sect2 id="svn.tour.revs.keywords">
+      <!-- @ENGLISH {{{
+      <title>Revision Keywords</title>
+      @ENGLISH }}} -->
+      <title>Nøkkelord for revisjoner</title>
+      
+      <!-- @ENGLISH {{{
+      <para>The Subversion client understands a number of
+        <firstterm>revision keywords</firstterm>.  These keywords can
+        be used instead of integer arguments to the
+        <option>-ﳢ-revision</option> switch, and are resolved into
+        specific revision numbers by Subversion:</para>
+      @ENGLISH }}} -->
+      <para>Subversionklienten forstår noen 
+        <firstterm>revisjonsnøkkelord</firstterm>.
+        Disse nøkkelordene kan bli brukt istedenfor heltallsargumenter 
+        til <option>--revision</option>-valget, og blir oversatt til 
+        spesifikke revisjonsnumre av Subversion:</para>
+
+      <variablelist>
+        
+        <varlistentry>
+          <term>HEAD</term>
+          <listitem>
+            <!-- @ENGLISH {{{
+            <para>The latest (or <quote>youngest</quote>) revision in
+              the repository.</para>
+            @ENGLISH }}} -->
+            <para>Den seneste (eller <quote>yngste</quote>) revisjonen i 
+              depotet.</para>
+          </listitem>
+        </varlistentry>
+        
+        <varlistentry>
+          <term>BASE</term>
+          <listitem>
+            <!-- @ENGLISH {{{
+            <para>The revision number of an item in a working copy.
+              If the item has been locally modified, the <quote>BASE
+              version</quote> refers to the way the item appears
+              without those local modifications.</para>
+            @ENGLISH }}} -->
+            <para>Revisjonsnummeret til et element i en arbeidskopi.
+              Hvis elementet inneholder lokale forandringer, refererer 
+              <quote>BASE-versjonen</quote> til det som elementet ser ut 
+              som når disse forandringene ikke er til stede.</para>
+          </listitem>
+        </varlistentry>
+        
+        <varlistentry>
+          <term>COMMITTED</term>
+          <listitem>
+            <!-- @ENGLISH {{{
+            <para>The most recent revision prior to, or equal to,
+              <literal>BASE</literal>, in which an item changed.</para>
+            @ENGLISH }}} -->
+            <para>Den seneste revisjonen før eller lik 
+              <literal>BASE</literal>, der et element ble 
+              forandret.</para>
+          </listitem>
+        </varlistentry>
+        
+        <varlistentry>
+          <term>PREV</term>
+          <listitem>
+            <!-- @ENGLISH {{{
+            <para>The revision immediately <emphasis>before</emphasis>
+              the last revision in which an item changed.
+              Technically, this boils down to
+              <literal>COMMITTED</literal>-1.</para>
+            @ENGLISH }}} -->
+            <para>Revisjonen like <emphasis>før</emphasis> den siste 
+              revisjonen der et element ble forandret.
+              Teknisk sett koker dette ned til 
+              <literal>COMMITTED</literal>-1.</para>
+          </listitem>
+        </varlistentry>
+        
+      </variablelist>
+
+<!-- @TR {{ -->
+      <para>As can be derived from their descriptions, the
+        <literal>PREV</literal>, <literal>BASE</literal>, and
+        <literal>COMMITTED</literal> revision keywords are used only
+        when referring to a working copy path—they don't apply
+        to repository URLs.  <literal>HEAD</literal>, on the other
+        hand, can be used in conjuction with both of these path
+        types.</para>
+<!-- @TR }} -->
+      
+      <!-- @ENGLISH {{{
+      <para>Here are some examples of revision keywords in action.
+        Don't worry if the commands don't make sense yet; we'll be
+        explaining these commands as we go through the chapter:</para>
+      @ENGLISH }}} -->
+      <para>Her er noen eksempler på revisjonsnøkkelord i aksjon.
+        Ikke bli urolig om du ikke forstår den fulle betydningen av 
+        kommandoene enda; vi vil forklare disse kommandoene mens vi går 
+        gjennom kapittelet:</para>
+      
+      <!-- @ENGLISH {{{
+      <screen>
+$ svn diff -r PREV:COMMITTED foo.c
+# shows the last change committed to foo.c
+
+$ svn log -r HEAD
+# shows log message for the latest repository commit
+
+$ svn diff -r HEAD
+# compares your working copy (with all of its local changes) to the
+# latest version of that tree in the repository
+
+$ svn diff -r BASE:HEAD foo.c
+# compares the unmodified version of foo.c with the latest version of
+# foo.c in the repository
+
+$ svn log -r BASE:HEAD
+# shows all commit logs for the current versioned directory since you
+# last updated
+
+$ svn update -r PREV foo.c
+# rewinds the last change on foo.c, decreasing foo.c's working revision
+
+$ svn diff -r BASE:14 foo.c
+# compares the unmodified version of foo.c with the way foo.c looked
+# in revision 14
+</screen>
+      @ENGLISH }}} -->
+      <screen>
+$ svn diff -r PREV:COMMITTED foo.c
+# viser den siste forandringen lagt inn i foo.c
+
+$ svn log -r HEAD
+# viser loggmelding for den seneste innleggingen i depotet
+
+$ svn diff -r HEAD
+# sammenligner arbeidskopien din (med alle lokale forandringer) med den 
+# seneste versjonen av det treet i depotet
+
+$ svn diff -r BASE:HEAD foo.c
+# sammenligner den umodifiserte versjonen av foo.c mot den seneste 
+# versjonen av foo.c i depotet
+
+$ svn log -r BASE:HEAD
+# viser alle loggmeldinger for den nåværende versjonerte katalogen siden 
+# du sist oppdaterte
+
+$ svn update -r PREV foo.c
+# omgjør den nyeste forandringen i foo.c og minsker arbeidsrevisjonen 
+# for foo.c
+
+$ svn diff -r BASE:14 foo.c
+# sammenligner den umodifiserte versjonen av foo.c med det foo.c var i 
+# revisjon 14
+</screen>
+      
+    </sect2>
+    
+    <!-- =============================================================== -->
+    <sect2 id="svn.tour.revs.dates">
+      <!-- @ENGLISH {{{
+      <title>Revision Dates</title>
+      @ENGLISH }}} -->
+      <title>Revisjonsdatoer</title>
+      
+<!-- @TR {{ -->
+      <para>Revision numbers reveal nothing about the world outside
+        the version control system, but sometimes you need to
+        correlate a moment in real time with a moment in version
+        history.  To facilitate this, the <option>--revision</option>
+        option can also accept as input date specifiers wrapped in
+        curly braces (<literal>{</literal> and <literal>}</literal>).
+        Subversion accepts the standard ISO-8601 date and time
+        formats, plus a few others.  Here are some examples.
+        (Remember to use quotes around any date that contains
+        spaces.)</para>
+<!-- @TR }} -->
+
+      <!-- @ENGLISH {{{
+      <screen>
+$ svn checkout -r {2002-02-17}
+$ svn checkout -r {15:30}
+$ svn checkout -r {15:30:00.200000}
+$ svn checkout -r {"2002-02-17 15:30"}
+$ svn checkout -r {"2002-02-17 15:30 +0230"}
+$ svn checkout -r {2002-02-17T15:30}
+$ svn checkout -r {2002-02-17T15:30Z}
+$ svn checkout -r {2002-02-17T15:30-04:00}
+$ svn checkout -r {20020217T1530}
+$ svn checkout -r {20020217T1530Z}
+$ svn checkout -r {20020217T1530-0500}
+…
+</screen>
+      @ENGLISH }}} -->
+      <screen>
+$ svn checkout -r {2002-02-17}
+$ svn checkout -r {15:30}
+$ svn checkout -r {15:30:00.200000}
+$ svn checkout -r {"2002-02-17 15:30"}
+$ svn checkout -r {"2002-02-17 15:30 +0230"}
+$ svn checkout -r {2002-02-17T15:30}
+$ svn checkout -r {2002-02-17T15:30Z}
+$ svn checkout -r {2002-02-17T15:30-04:00}
+$ svn checkout -r {20020217T1530}
+$ svn checkout -r {20020217T1530Z}
+$ svn checkout -r {20020217T1530-0500}
+…
+</screen>
+      
+<!-- @TR {{ -->
+      <para>When you specify a date, Subversion resolves that date to
+        the most recent revision of the repository as of that date,
+        and then continues to operate against that resolved revision
+        number:</para>
+<!-- @TR }} -->
+        
+      <!-- @ENGLISH {{{
+      <screen>
+$ svn log -r {2002-11-28}
+-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-
+r12 | ira | 2002-11-27 12:31:51 -0600 (Wed, 27 Nov 2002) | 6 lines
+…
+</screen>
+      @ENGLISH }}} -->
+      <screen>
+$ svn log -r {2002-11-28}
+------------------------------------------------------------------------
+r12 | ira | 2002-11-27 12:31:51 -0600 (ons, 27 nov 2002) | 6 lines
+…
+</screen>
+        
+      <sidebar>
+        <!-- @ENGLISH {{{
+        <title>Is Subversion a Day Early?</title>
+        @ENGLISH }}} -->
+        <title>Er Subversion en dag for tidlig ute?</title>
+        
+        <!-- @ENGLISH {{{
+        <para>If you specify a single date as a revision without
+          specifying a time of day (for example
+          <literal>2002-11-27</literal>), you may think that Subversion
+          should give you the last revision that took place on the
+          27th of November.  Instead, you'll get back a revision from
+          the 26th, or even earlier.  Remember that Subversion will
+          find the <emphasis>most recent revision of the
+          repository</emphasis> as of the date you give.  If you give
+          a date without a timestamp, like
+          <literal>2002-11-27</literal>, Subversion assumes a time of
+          00:00:00, so looking for the most recent revision won't
+          return anything on the day of the 27th.</para>
+        @ENGLISH }}} -->
+        <para>Hvis du spesifiserer en enkelt dato som en revisjon uten å 
+          spesifisere klokkeslett (for eksempel 
+          <literal>2002-11-27</literal>, forventer du kanskje at 
+          Subversion skal gi deg den siste revisjonen som ble opprettet 
+          27. november.
+          Istedenfor får du en revisjon fra den 26., eller til og med 
+          enda tidligere.
+          Husk at Subversion vil finne den <emphasis>nyeste versjonen i 
+          depotet</emphasis> på den datoen du oppgir.
+          Hvis du angir en dato uten klokkeslett, som 
+          <literal>2002-11-27</literal>, bruker Subversion klokkeslettet 
+          00:00:00, så det å se etter den nyeste revisjonen vil ikke 
+          returnere noe som helst fra denne datoen.</para>
+
+        <!-- @ENGLISH {{{
+        <para>If you want to include the 27th in your search, you can
+          either specify the 27th with the time (<literal>{"2002-11-27
+          23:59"}</literal>), or just specify the next day
+          (<literal>{2002-11-28}</literal>).</para>
+        @ENGLISH }}} -->
+        <para>Hvis du ønsker å inkludere den 27de i letingen, kan du 
+          enten spesifisere den 27de med klokkeslett 
+          (<literal>{"2002-11-27 23:59"}</literal>, eller bare 
+          spesifisere den neste dagen 
+          (<literal>{2002-11-28}</literal>).</para>
+        
+      </sidebar>
+      
+      <!-- @ENGLISH {{{
+      <para>You can also use a range of dates.  Subversion will find
+        all revisions between both dates, inclusive:</para>
+      @ENGLISH }}} -->
+      <para>Du kan også bruke et område av datoer.
+        Subversion vil finne alle revisjoner mellom to datoer, 
+        inkludert:</para>
+      
+      <!-- @ENGLISH {{{
+      <screen>
+$ svn log -r {2002-11-20}:{2002-11-29}
+…
+</screen>
+      @ENGLISH }}} -->
+      <screen>
+$ svn log -r {2002-11-20}:{2002-11-29}
+…
+</screen>
+        
+      <!-- @ENGLISH {{{
+      <para>As we pointed out, you can also mix dates and revisions:</para>
+      @ENGLISH }}} -->
+      <para>Som vi har påpekt, kan du også blande datoer og 
+        revisjoner:</para>
+      
+      <!-- @ENGLISH {{{
+      <screen>
+$ svn log -ﳢ-revision {2002-11-20}:4040
+</screen>
+      @ENGLISH }}} -->
+      <screen>
+$ svn log --revision {2002-11-20}:4040
+</screen>
+
+      <warning>
+      <!-- @ENGLISH {{{
+        <para>Since the timestamp of a revision is stored as an
+          unversioned, modifiable property of the revision (see <xref
+          linkend="svn.advanced.props" />, revision timestamps can be
+          changed to represent complete falsifications of true
+          chronology, or even removed altogether.  This will wreak
+          havoc on the internal date-to-revision conversion that
+          Subversion performs.</para>
+      @ENGLISH }}} -->
+      <para>Siden tidspunktet på en revisjon er lagret som en 
+        uversjonert, redigerbar egenskap for revisjonen (se <xref 
+        linkend="svn.advanced.props" />, kan revisjonsegenskaper bli 
+        forandret til å representere en kronologi som ikke stemmer, 
+        eller kan til og med bli fjernet helt.
+        Dette vil rote til den interne 
+        <quote>dato-til-revisjon</quote>-konverteringen som Subversion 
+        utfører.</para>
+      </warning>
+        
+    </sect2>
+      
+  </sect1>
+
+  <!-- ================================================================= -->
+  <!-- ================================================================= -->
+  <!-- ================================================================= -->
   <sect1 id="svn.advanced.pegrevs">
+<!-- @TR {{ -->
     <title>Peg and Operative Revisions</title>
 
     <para>We make use of the ability to copy, move, rename, and

Modified: trunk/src/nb/book/ch-basic-usage.xml
==============================================================================
--- trunk/src/nb/book/ch-basic-usage.xml	(original)
+++ trunk/src/nb/book/ch-basic-usage.xml	Thu Jun 14 09:09:41 2007
@@ -104,67 +104,34 @@
   <!-- ================================================================= -->
   <sect1 id="svn.tour.revs">
     <!-- @ENGLISH {{{
-    <title>Revisions: Numbers, Keywords, and Dates, Oh My!</title>
+    <title>Time Travel with Subversion</title>
     @ENGLISH }}} -->
-    <title>Revisjoner: Nummer, nøkkelord og datoer, <!-- ¤ 
-    -->oj!</title>
+    <title>Tidsreiser med Subversion</title>
 
-    <!-- @ENGLISH {{{
-    <para>Before we go on, you should know a bit about how to identify
-      a particular revision in your repository.  As you learned in
-      <xref linkend="svn.basic.in-action.revs"/>, a revision is a
-      <quote>snapshot</quote> of the repository at a particular moment
-      in time.  As you continue to commit and grow your repository,
-      you need a mechanism for identifying these snapshots.</para>
-    @ENGLISH }}} -->
-    <para>Før vi går videre, bør du vite litt om hvordan du kan 
-      identifisere en spesiell revisjon i depotet.
-      Som du lærte i <xref linkend="svn.basic.in-action.revs"/>, er en 
-      revisjon et <quote>øyeblikksbilde</quote> av depotet på et visst 
-      tidspunkt.
-      Når du fortsetter med å legge inn revisjoner og øker størrelsen på 
-      depotet ditt, trenger du en mekanisme for å identifisere disse 
-      øyeblikksbildene.</para>
-
-    <!-- @ENGLISH {{{
-    <para>You specify these revisions by using the
-      <option>-ﳢ-revision</option> (<option>-r</option>) switch plus
-      the revision you want (<command>svn -ﳢ-revision REV</command>) or
-      you can specify a range by separating two revisions with a colon
-      (<command>svn -ﳢ-revision REV1:REV2</command>).  And Subversion
-      lets you refer to these revisions by number, keyword, or
-      date.</para>
-    @ENGLISH }}} -->
-    <para>Du spesifiserer disse revisjonene ved å bruke 
-      <option>--revision</option> (<option>-r</option>)-valget pluss 
-      revisjonen du ønsker (<command>svn --revision REV</command> eller 
-      du kan spesifisere et område ved å separere to revisjoner med et 
-      kolon (<command>svn --revision REV1:REV2</command>).
-      Og Subversion lar deg referere til disse revisjonene via nummer, 
-      nøkkelord eller dato.</para>
-    
-    <!-- =============================================================== -->
-    <sect2 id="svn.tour.revs.numbers">
-      <!-- @ENGLISH {{{
-      <title>Revision Numbers</title>
-      @ENGLISH }}} -->
-      <title>Revisjonsnumre</title>
-      
-      <!-- @ENGLISH {{{
-      <para>When you create a new Subversion repository, it begins its
-        life at revision zero and each successive commit increases the
-        revision number by one.  After your commit completes, the
-        Subversion client informs you of the new revision
-        number:</para>
-      @ENGLISH }}} -->
-      <para>Når du lager et nytt Subversiondepot, begynner det livet 
-        sitt på revisjon null og hver etterfølgende innlegging øker 
-        revisjonsnummeret med en.
-        Etter at innleggingen din er fullført, informerer 
-        Subversionklienten deg om det nye revisjonsnummeret:</para>
+<!-- @TR {{ -->
+    <para>As discussed in <xref linkend="svn.basic.in-action.revs"/>,
+      a revision is a <quote>snapshot</quote> of the repository at a
+      particular moment in time.  But the thing that makes
+      Subversion—or any other version control
+      system—useful is not that it keeps all the versions of
+      your files and directories over time.  It's that you can
+      actually <emphasis>do something</emphasis> with those older
+      versions!  And to do this sort of time travelling, you need a
+      mechanism for identifying revision snapshots.</para>
+
+    <para>Revision numbers in Subversion are pretty
+      straightforward—just monotonically increasing integers.
+      When you create a new Subversion repository, it begins its life
+      at revision 0 and each successive commit increases the revision
+      number by one.  Subversion doesn't try to hide these
+      numbers—they are a part of the interface you have into the
+      history of your versioned data.  For example, after you perform
+      a commit, the Subversion client informs you of the new revision
+      number:</para>
+<!-- @TR }} -->
       
-      <!-- @ENGLISH {{{
-      <screen>
+    <!-- @ENGLISH {{{
+    <screen>
 $ svn commit -ﳢ-message "Corrected number of cheese slices."
 Sending        sandwich.txt
 Transmitting file data .
@@ -179,396 +146,43 @@
 </screen>
 
       <!-- @ENGLISH {{{
-      <para>If at any point in the future you want to refer to that
-        revision (we'll see how and why we might want to do that later
-        in this chapter), you can refer to it as
-        <quote>3</quote>.</para>
+    <para>If at any point in the future you want to refer to that
+      revision, you can do so by specifying it as
+      <literal>3</literal>.  We'll discover some reasons why you might
+      want to do that later in this chapter.</para>
       @ENGLISH }}} -->
       <para>Hvis du på et punkt i fremtiden vil referere til den 
         revisjonen (vi vil se hvordan og hvorfor vi kanskje skulle ønske 
         å gjøre det senere i dette kapitlet), kan du referere til den 
         som <quote>3</quote>.</para>
 
-    </sect2>
-    
-    <!-- =============================================================== -->
-    <sect2 id="svn.tour.revs.keywords">
-      <!-- @ENGLISH {{{
-      <title>Revision Keywords</title>
-      @ENGLISH }}} -->
-      <title>Nøkkelord for revisjoner</title>
-      
-      <!-- @ENGLISH {{{
-      <para>The Subversion client understands a number of
-        <firstterm>revision keywords</firstterm>.  These keywords
-        can be used instead of integer arguments to the
-        <option>-ﳢ-revision</option> switch, and are resolved into
-        specific revision numbers by Subversion:</para>
-      @ENGLISH }}} -->
-      <para>Subversionklienten forstår noen 
-        <firstterm>revisjonsnøkkelord</firstterm>.
-        Disse nøkkelordene kan bli brukt istedenfor heltallsargumenter 
-        til <option>--revision</option>-valget, og blir oversatt til 
-        spesifikke revisjonsnumre av Subversion:</para>
-
-      <note>
-        <!-- @ENGLISH {{{
-        <para>Each directory in your working copy contains an
-          administrative subdirectory called
-          <filename>.svn</filename>.  For every file in a directory,
-          Subversion keeps a copy of each file in the administrative
-          area.  This copy is an unmodified (no keyword expansion, no
-          end-of-line translation, no nothing) copy of the file as it
-          existed in the last revision (called the <quote>BASE</quote>
-          revision) that you updated it to in your working copy.  We
-          refer to this file as the <firstterm>pristine
-          copy</firstterm> or <firstterm>text-base</firstterm> version
-          of your file, and it's always an exact byte-for-byte copy of
-          the file as it exists in the repository.</para> 
-        @ENGLISH }}} -->
-        <para>Hver katalog i arbeidskopien din inneholder en 
-          administrativ underkatalog kalt <filename>.svn</filename>.
-          For hver eneste fil i en katalog lagrer Subversion en kopi av 
-          hver fil i det administrative området.
-          Denne kopien er en en umodifisert (ingen nøkkelordutvidelser, 
-          ingen linjesluttkonvertering, ingen noesomhelst) kopi av fila 
-          som da den eksisterte i den siste revisjonen (kalt 
-          <quote>BASE</quote>-revisjonen) som du oppdaterte den til i 
-          arbeidskopien din.
-          Vi refererer til denne fila som den <firstterm>uberørte 
-          kopien</firstterm> eller 
-          <firstterm>text-base</firstterm>-versjonen av fila, og det er 
-          alltid en eksakt byte-for-byte-kopi av fila som den eksisterer 
-          i depotet.</para>
-        </note>
-      
-      <variablelist>
-        
-        <varlistentry>
-          <term>HEAD</term>
-          <listitem>
-            <!-- @ENGLISH {{{
-            <para>The latest (or <quote>youngest</quote>) revision in
-              the repository.</para>
-            @ENGLISH }}} -->
-            <para>Den seneste (eller <quote>yngste</quote>) revisjonen i 
-              depotet.</para>
-          </listitem>
-        </varlistentry>
-        
-        <varlistentry>
-          <term>BASE</term>
-          <listitem>
-            <!-- @ENGLISH {{{
-            <para>The revision number of an item in a working copy.
-              If the item has been locally modified, the <quote>BASE
-              version</quote> refers to the way the item appears
-              without those local modifications.</para>
-            @ENGLISH }}} -->
-            <para>Revisjonsnummeret til et element i en arbeidskopi.
-              Hvis elementet inneholder lokale forandringer, refererer 
-              <quote>BASE-versjonen</quote> til det som elementet ser ut 
-              som når disse forandringene ikke er til stede.</para>
-          </listitem>
-        </varlistentry>
-        
-        <varlistentry>
-          <term>COMMITTED</term>
-          <listitem>
-            <!-- @ENGLISH {{{
-            <para>The most recent revision prior to, or equal to,
-              <literal>BASE</literal>, in which an item changed.</para>
-            @ENGLISH }}} -->
-            <para>Den seneste revisjonen før eller lik 
-              <literal>BASE</literal>, der et element ble 
-              forandret.</para>
-          </listitem>
-        </varlistentry>
-        
-        <varlistentry>
-          <term>PREV</term>
-          <listitem>
-            <!-- @ENGLISH {{{
-            <para>The revision immediately <emphasis>before</emphasis>
-              the last revision in which an item changed.
-              (Technically, <literal>COMMITTED</literal> - 1.)</para>
-            @ENGLISH }}} -->
-            <para>Revisjonen like <emphasis>før</emphasis> den siste 
-              revisjonen der et element ble forandret.
-              (Teknisk sett, <literal>COMMITTED</literal> - 1.)</para>
-          </listitem>
-        </varlistentry>
-        
-      </variablelist>
-
-      <note>
-        <!-- @ENGLISH {{{
-        <para><literal>PREV</literal>, <literal>BASE</literal>, and
-          <literal>COMMITTED</literal> can be used to refer to local
-          paths, but not to URLs.</para>
-        @ENGLISH }}} -->
-        <para><literal>PREV</literal>, <literal>BASE</literal> og 
-          <literal>COMMTTED</literal> kan bli brukt til å referere til 
-          lokale stier, men ikke til URLer.</para>
-      </note>
-      
-      <!-- @ENGLISH {{{
-      <para>Here are some examples of revision keywords in action.
-        Don't worry if the commands don't make sense yet; we'll be
-        explaining these commands as we go through the chapter:</para>
-      @ENGLISH }}} -->
-      <para>Her er noen eksempler på revisjonsnøkkelord i aksjon.
-        Ikke bli urolig om du ikke forstår den fulle betydningen av 
-        kommandoene enda; vi vil forklare disse kommandoene mens vi går 
-        gjennom kapittelet:</para>
-      
-      <!-- @ENGLISH {{{
-      <screen>
-$ svn diff -ﳢ-revision PREV:COMMITTED foo.c
-# shows the last change committed to foo.c
-
-$ svn log -ﳢ-revision HEAD
-# shows log message for the latest repository commit
-
-$ svn diff -ﳢ-revision HEAD
-# compares your working file (with local changes) to the latest version
-# in the repository
-
-$ svn diff -ﳢ-revision BASE:HEAD foo.c
-# compares your <quote>pristine</quote> foo.c (no local changes) with the 
-# latest version in the repository
-
-$ svn log -ﳢ-revision BASE:HEAD
-# shows all commit logs since you last updated
-
-$ svn update -ﳢ-revision PREV foo.c
-# rewinds the last change on foo.c
-# (foo.c's working revision is decreased)
-</screen>
-      @ENGLISH }}} -->
-      <screen>
-$ svn diff --revision PREV:COMMITTED foo.c
-# viser den siste forandringen lagt inn i foo.c
-
-$ svn log --revision HEAD
-# viser loggmelding for den seneste innleggingen i depotet
-
-$ svn diff --revision HEAD
-# sammenligner arbeidsfila di (med lokale forandringer) med den seneste 
-# versjonen i depotet
-
-$ svn diff --revision BASE:HEAD foo.c
-# sammenligner din <quote>uberørte</quote> foo.c (ingen lokale 
-# modifikasjoner) mot den seneste versjonen i depotet
-
-$ svn log --revision BASE:HEAD
-# viser alle loggmeldinger siden du sist oppdaterte
-
-$ svn update --revision PREV foo.c
-# setter tilbake til den forrige forandringen på foo.c
-# (Arbeidsrevisjonen til foo.c minsker)
-</screen>
-      
-      <!-- @ENGLISH {{{
-      <para>These keywords allow you to perform many common (and
-        helpful) operations without having to look up specific
-        revision numbers or remember the exact revision of your
-        working copy.</para>
-      @ENGLISH }}} -->
-      <para>Disse nøkkelordene tillater deg å utføre mange vanlige (og 
-        hjelpsomme) operasjoner uten å måtte lete opp spesielle 
-        revisjonsnumre eller huske den eksakte revisjonen til 
-        arbeidskopien din.</para>
-      
-    </sect2>
-    
-    <!-- =============================================================== -->
-    <sect2 id="svn.tour.revs.dates">
-      <!-- @ENGLISH {{{
-      <title>Revision Dates</title>
-      @ENGLISH }}} -->
-      <title>Revisjonsdatoer</title>
-      
-      <!-- @ENGLISH {{{
-      <para>Anywhere that you specify a revision number or revision
-        keyword, you can also specify a date
-        inside curly braces <quote>{}</quote>.  You can even access
-        a range of changes in the repository using both dates and
-        revisions together!</para>
-      @ENGLISH }}} -->
-      <para>Alle plasser du spesifiserer et revisjonsnummer eller 
-        revisjonsnøkkelord, kan du også spesifisere en dato innenfor 
-        krøllparenteser <quote>{}</quote>.
-        Du kan til og med aksessere et område av forandringer i depotet 
-        ved å bruke både datoer og revisjoner sammen!</para>
-      
-      <!-- @ENGLISH {{{
-      <para>Here are examples of the date formats that Subversion
-        accepts.  Remember to use quotes around any date that contains
-        spaces.</para>
-      @ENGLISH }}} -->
-      <para>Her er eksempler på dataformater som Subversion aksepterer.
-        Husk å bruke anførselstegn rundt datoer som inneholder 
-        mellomrom.</para>
-
-      <!-- @ENGLISH {{{
-      <screen>
-$ svn checkout -ﳢ-revision {2002-02-17}
-$ svn checkout -ﳢ-revision {15:30}
-$ svn checkout -ﳢ-revision {15:30:00.200000}
-$ svn checkout -ﳢ-revision {"2002-02-17 15:30"}
-$ svn checkout -ﳢ-revision {"2002-02-17 15:30 +0230"}
-$ svn checkout -ﳢ-revision {2002-02-17T15:30}
-$ svn checkout -ﳢ-revision {2002-02-17T15:30Z}
-$ svn checkout -ﳢ-revision {2002-02-17T15:30-04:00}
-$ svn checkout -ﳢ-revision {20020217T1530}
-$ svn checkout -ﳢ-revision {20020217T1530Z}
-$ svn checkout -ﳢ-revision {20020217T1530-0500}
-…
-</screen>
-      @ENGLISH }}} -->
-      <screen>
-$ svn checkout --revision {2002-02-17}
-$ svn checkout --revision {15:30}
-$ svn checkout --revision {15:30:00.200000}
-$ svn checkout --revision {"2002-02-17 15:30"}
-$ svn checkout --revision {"2002-02-17 15:30 +0230"}
-$ svn checkout --revision {2002-02-17T15:30}
-$ svn checkout --revision {2002-02-17T15:30Z}
-$ svn checkout --revision {2002-02-17T15:30-04:00}
-$ svn checkout --revision {20020217T1530}
-$ svn checkout --revision {20020217T1530Z}
-$ svn checkout --revision {20020217T1530-0500}
-…
-</screen>
-      
-      <!-- @ENGLISH {{{
-      <para>When you specify a date as a revision, Subversion finds
-        the most recent revision of the repository as of that
-        date:</para>
-      @ENGLISH }}} -->
-      <para>Når du spesifiserer en dato som en revisjon, finner 
-        Subversion den nyeste revisjonen på denne datoen:</para>
-        
-      <!-- @ENGLISH {{{
-      <screen>
-$ svn log -ﳢ-revision {2002-11-28}
--ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-ﳢ-
-r12 | ira | 2002-11-27 12:31:51 -0600 (Wed, 27 Nov 2002) | 6 lines
-…
-</screen>
-      @ENGLISH }}} -->
-      <screen>
-$ svn log --revision {2002-11-28}
-------------------------------------------------------------------------
-r12 | ira | 2002-11-27 12:31:51 -0600 (ons, 27 nov 2002) | 6 lines
-…
-</screen>
-        
-      <sidebar>
-        <!-- @ENGLISH {{{
-        <title>Is Subversion a Day Early?</title>
-        @ENGLISH }}} -->
-        <title>Er Subversion en dag for tidlig ute?</title>
-        
-        <!-- @ENGLISH {{{
-        <para>If you specify a single date as a revision without
-          specifying a time of day (for example
-          <literal>2002-11-27</literal>), you may think that Subversion
-          should give you the last revision that took place on the
-          27th of November.  Instead, you'll get back a revision from
-          the 26th, or even earlier.  Remember that Subversion will
-          find the <emphasis>most recent revision of the
-          repository</emphasis> as of the date you give.  If you give
-          a date without a timestamp, like
-          <literal>2002-11-27</literal>, Subversion assumes a time of
-          00:00:00, so looking for the most recent revision won't
-          return anything on the day of the 27th.</para>
-        @ENGLISH }}} -->
-        <para>Hvis du spesifiserer en enkelt dato som en revisjon uten å 
-          spesifisere klokkeslett (for eksempel 
-          <literal>2002-11-27</literal>, forventer du kanskje at 
-          Subversion skal gi deg den siste revisjonen som ble opprettet 
-          27. november.
-          Istedenfor får du en revisjon fra den 26., eller til og med 
-          enda tidligere.
-          Husk at Subversion vil finne den <emphasis>nyeste versjonen i 
-          depotet</emphasis> på den datoen du oppgir.
-          Hvis du angir en dato uten klokkeslett, som 
-          <literal>2002-11-27</literal>, bruker Subversion klokkeslettet 
-          00:00:00, så det å se etter den nyeste revisjonen vil ikke 
-          returnere noe som helst fra denne datoen.</para>
-
-        <!-- @ENGLISH {{{
-        <para>If you want to include the 27th in your search, you can
-          either specify the 27th with the time (<literal>{"2002-11-27
-          23:59"}</literal>), or just specify the next day
-          (<literal>{2002-11-28}</literal>).</para>
-        @ENGLISH }}} -->
-        <para>Hvis du ønsker å inkludere den 27de i letingen, kan du 
-          enten spesifisere den 27de med klokkeslett 
-          (<literal>{"2002-11-27 23:59"}</literal>, eller bare 
-          spesifisere den neste dagen 
-          (<literal>{2002-11-28}</literal>).</para>
-        
-      </sidebar>
-      
-      <!-- @ENGLISH {{{
-      <para>You can also use a range of dates.  Subversion will find
-        all revisions between both dates, inclusive:</para>
-      @ENGLISH }}} -->
-      <para>Du kan også bruke et område av datoer.
-        Subversion vil finne alle revisjoner mellom to datoer, 
-        inkludert:</para>
-      
-      <!-- @ENGLISH {{{
-      <screen>
-$ svn log -ﳢ-revision {2002-11-20}:{2002-11-29}
-…
-</screen>
-      @ENGLISH }}} -->
-      <screen>
-$ svn log --revision {2002-11-20}:{2002-11-29}
-…
-</screen>
-        
-      <!-- @ENGLISH {{{
-      <para>As we pointed out, you can also mix dates and revisions:</para>
-      @ENGLISH }}} -->
-      <para>Som vi har påpekt, kan du også blande datoer og 
-        revisjoner:</para>
-      
-      <!-- @ENGLISH {{{
-      <screen>
-$ svn log -ﳢ-revision {2002-11-20}:4040
-</screen>
-      @ENGLISH }}} -->
-      <screen>
-$ svn log --revision {2002-11-20}:4040
-</screen>
+<!-- @TR {{ -->
+    <para>The <command>svn</command> command-line client provides a
+      pair of options for specifying the revisions you wish to operate
+      on.  The most common of these is the <option>--revision</option>
+      (<option>-r</option>), which accepts as a parameter either a
+      single revision specifier (<option>-r
+      <replaceable>REV</replaceable></option>), or a pair of them
+      separated by a colon (<option>-r
+      <replaceable>REV1</replaceable>:<replaceable>REV2</replaceable></option>).
+      This latter format is used to describe a <firstterm>revision
+      range</firstterm>, useful for commands that compare two revision
+      snapshots or operate on every revision between two specified
+      extremes, inclusively.</para>
+
+    <para>Subversion 1.4 introduced a second option for specifying
+      revision ranges, the <option>--change</option>
+      (<option>-c</option>) option.  This is basically just a shortcut
+      for specifying a range of revisions whose boundaries are
+      sequential integers.  In other words, using <option>-c
+      <replaceable>REV</replaceable></option> is the same thing as
+      using <option>-r
+      <replaceable>REV</replaceable>-1:<replaceable>REV</replaceable></option>.
+      And you can trivially reverse the implied range, too, by putting
+      a dash in front of the revision number, as in <option>-c
+      -<replaceable>REV</replaceable></option>.</para>
+<!-- @TR }} -->
 
-      <!-- @ENGLISH {{{
-      <para>Users should be aware of a subtlety that can become quite
-        a stumbling-block when dealing with dates in Subversion.  Since
-        the timestamp of a revision is stored as a property of the
-        revision—an unversioned, modifiable
-        property—revision timestamps can be changed to represent
-        complete falsifications of true chronology, or even removed
-        altogether.  This will wreak havoc on the internal
-        date-to-revision conversion that Subversion performs.</para>
-      @ENGLISH }}} -->
-      <para>Brukere bør være klar over en spissfindighet som kan bli 
-        litt av en snublestein ved bruk av datoer i Subversion.
-        Siden tidspunktet på en revisjon er lagret som en egenskap for 
-        revisjonen – en uversjonert, modifiserbar egenskap – kan 
-        revisjonsegenskaper bli forandret til å representere helt feil 
-        kronologi, eller kan til og med bli fjernet helt.
-        Dette vil rote til den interne 
-        <quote>dato-til-revisjon</quote>-konverteringen som Subversion 
-        utfører.</para>
-        
-    </sect2>
-      
   </sect1>
 
   <!-- ================================================================= -->




More information about the svnbook-dev mailing list