[svnbook commit] r1493 - in trunk/src/ru: . book
dmitriy
svnbook-dev at red-bean.com
Sat Jun 25 15:12:59 CDT 2005
Author: dmitriy
Date: Sat Jun 25 15:12:58 2005
New Revision: 1493
Modified:
trunk/src/ru/HACKING
trunk/src/ru/book/ch06.xml
trunk/src/ru/book/ch09.xml
trunk/src/ru/sync.py
Log:
* sync.py
Added option for viewing log for all directory
en/book/
* HACKING
Corrected grammatic error
* book/ch06.xml
* book/ch09.xml
Merged with en/
Modified: trunk/src/ru/HACKING
==============================================================================
--- trunk/src/ru/HACKING (original)
+++ trunk/src/ru/HACKING Sat Jun 25 15:12:58 2005
@@ -2,18 +2,18 @@
Общий стиль перевода
====================
-Как и в английском оригинале, следует придерживаться стиля среднего
-между формальным и неформальным. Оригинал написан отличным живым
-английским языком, перевод также должен быть выполнен отличным живым
+Как и в английском оригинале, следует придерживаться стиля среднего
+между формальным и неформальным. Оригинал написан отличным живым
+английским языком, перевод также должен быть выполнен отличным живым
русским языком.
-В переводе следует стремиться использовать русскоязычную терминологию
-(см. глоссарий для переводчиков). Глоссарий не является догмой, его
-задача -- обеспечить последовательность использования терминов по всему
+В переводе следует стремиться использовать русскоязычную терминологию
+(см. глоссарий для переводчиков). Глоссарий не является догмой, его
+задача -- обеспечить последовательность использования терминов по всему
тексту книги, но в нём могут быть не учтены контекстуальные нюансы.
-Непереводимые фрагменты необходимо воспроизводить в точности так же, как
-в оригинале (например, использовать длинные названия команд: "checkout",
+Непереводимые фрагменты необходимо воспроизводить в точности так же, как
+в оригинале (например, использовать длинные названия команд: "checkout",
а не "co").
Используйте букву "ё" там, где это необходимо.
@@ -23,28 +23,28 @@
Руководство по разметке
=======================
-- В работе с книгой используется Docbook Lite DTD от O'Reilly &
- Associates. Копия DTD имеется в хранилище и также доступна по адресу
+- В работе с книгой используется Docbook Lite DTD от O'Reilly &
+ Associates. Копия DTD имеется в хранилище и также доступна по адресу
ftp://ftp.oreilly.com/pub/dblite/.
-- Перед публикацией *всегда* следует выполнять проверку правильности
- разметки xml. Не следует помещать в хранилище файл, не проходящий
+- Перед публикацией *всегда* следует выполнять проверку правильности
+ разметки xml. Не следует помещать в хранилище файл, не проходящий
такую проверку. Подробнее см. файл README.
-- Фрагменты, содержащие вывод на экране и программный код, не должны
- использовать строки длиннее, чем 78 символов. В качестве символа
+- Фрагменты, содержащие вывод на экране и программный код, не должны
+ использовать строки длиннее, чем 78 символов. В качестве символа
продолжения строки следует использовать обратную косую черту ('\').
-- Используйте — а не дефис, где это необходимо.
+- Используйте — а не дефис, где это необходимо.
-- Если в DTD имеется сущность, определённая для обозначения того или
- иного специального символа, используйте сущность, а не символ
+- Если в DTD имеется сущность, определённая для обозначения того или
+ иного специального символа, используйте сущность, а не символ
напрямую, например — вместо --.
-- В разметке следует использовать правильные отступы (2 символа), за
- исключением блоков <screen></screen>, которые выравниваются по левому
- краю. Текстовые узлы должны начинаться непосредственно после
- открывающего тэга и заканчиваться закрывающим тэгом, без лишних
+- В разметке следует использовать правильные отступы (2 символа), за
+ исключением блоков <screen></screen>, которые выравниваются по левому
+ краю. Текстовые узлы должны начинаться непосредственно после
+ открывающего тэга и заканчиваться закрывающим тэгом, без лишних
переносов строк. Например:
<chapter id="svn-ch-pi">
@@ -55,13 +55,13 @@
<!-- ================================================================= -->
<sect1 id="svn-ch-pi-sect-1">
<title>Flornthorple Plathering</title>
-
+
<para>The real key to <firstterm>Plathering</firstterm> is to start with
a good glab. A good glab provides a solid thorpy foundation.</para>
<sect2 id="svn-ch-pi-sect-1.1">
<title>Cross-blather</title>
-
+
<para>Cross-blather tends to create a hoopy pile of crandy. You
can avoid this by using the cross-blather avoid
command.</para>
@@ -71,7 +71,7 @@
Avoiding blather......... Done
$
</screen> <!-- Note the closing tag at the left-most column? -->
-
+
</sect2>
</sect1>
@@ -89,13 +89,13 @@
говоря, ничего нового в сам механизм слияния Subversion не привнесла, так
как для отражения изменений использует единый формат записи различий
(unified diff). Смотри: http://www.gnu.org/software/diffutils/manual/html_node/Detailed-Unified.html#Detailed%20Unified
-
+
При внесении изменений в целевой файл на основении diff-файлов алгоритм
ищет место, куда изменения были внесены. Зная о том что алгоритм
руководствуется он номерами строк И несколькими (обычно хватает трех)
неизмененными строками до и после блока измененных строк "викинги" этим
воспользовались.
-
+
Полагаясь на приципом "Ничего не удалять, только добавлять." при переводе
они стараются как можно меньше влиять на оригинальный текст, что бы не
сбивать с толку алгоритм наложения изменений. Так как книга оформлена при
@@ -110,7 +110,7 @@
блока комментариев испольуемые в XML. Сразу за блоком "закомментаренного"
оригинала следует его перевод. При этом, все использемые в оригинале теги
DocBook используются и в переводе.
-
+
Обратите внимание, на два важных правила:
1) Oбрамляемый тегами комментариев текст не должен нарушать "правильность
XML". То есть с точки зрения правил XML, файл должен оставаться
@@ -118,7 +118,7 @@
2) Чем больше строк оригинального текста будет обрамлено за раз, тем
проще будет жизнь у алгоритма наложения изменений! Так что,
НЕ МЕЛЬЧИТЕ когда делаете перевод!
-
+
BTW, в оригинальном тексте могут встречаться последовательности из двух
дефилов вида
===
@@ -138,29 +138,29 @@
===
В таком случае, для выполнения первого правила, приходится идти на
хитрости. Хитростей бывают двух видов: норвежская и наша.
-
+
"Варяги" разрывают последовательность двух дефисов Unicode-сущностью:
===
ﳢ
===
мотивируя это тем, что этот символ находиться в "private use" Unicode
area. Смотри: http://www.unicode.org/charts/PDF/UE000.pdf
-
+
Наша хитрость того же плана, но в качестве "разделителя" используется
вот такая последовательность:
===
-><!-
===
- Буду вставленной между уже существующими в оригинальном тексте
+ Будучи вставленной между уже существующими в оригинальном тексте
дефисами, она образует открывающий и закрывающий тег комментариев.
======
Разное
======
-- Всё, что требует внимания, или должно быть исправлено, должно быть
- помечено с помощью ###TODO, чтобы такие места можно было легко найти.
- Кроме того, не стесняйтесь добавлять своё имя в комментариях, чтобы
+- Всё, что требует внимания, или должно быть исправлено, должно быть
+ помечено с помощью ###TODO, чтобы такие места можно было легко найти.
+ Кроме того, не стесняйтесь добавлять своё имя в комментариях, чтобы
можно было вести обсуждение непосредственно в коде.
Modified: trunk/src/ru/book/ch06.xml
==============================================================================
--- trunk/src/ru/book/ch06.xml (original)
+++ trunk/src/ru/book/ch06.xml Sat Jun 25 15:12:58 2005
@@ -235,14 +235,43 @@
authenticate, then the client simply prompts the user for the
information.</para>
- <para>The security-paranoid people may be thinking to
- themselves, <quote>Caching passwords on disk? That's
- terrible! You should never do that!</quote> But please remain
- calm. First, the <filename>auth/</filename> caching area is
- permission-protected so that only the user (owner) can read
- data from it, not the world at large. If that's still not
- safe enough for you, you can disable credential caching. To
- disable caching for a single command, pass the
+ <para>Security-conscious people may be thinking to themselves,
+ <quote>Caching passwords on disk? That's terrible! You
+ should never do that!</quote> Please remain calm, it's not as
+ dangerous as it sounds.</para>
+
+ <itemizedlist>
+
+ <listitem>
+ <para>The <filename>auth/</filename> caching area is
+ permission-protected so that only the user (owner) can
+ read data from it, not the world at large. The operating
+ system's own file permissions are protecting the
+ password.</para>
+ </listitem>
+
+ <listitem>
+ <para>On Windows 2000 and later, the Subversion client uses
+ standard Windows cryptography services to encrypt the
+ password on disk. Because the encryption key is managed
+ by Windows and is tied to the user's own login
+ credentials, only the user can decrypt the cached
+ password. (Note: if the the user's Windows account
+ password is changed, all of the cached passwords become
+ undecipherable. The Subversion client will behave as if
+ they don't exist, prompting for passwords when
+ required.)</para>
+ </listitem>
+
+ <listitem>
+ <para>For the truly paranoid willing to sacrifice all
+ convenience, it's possible to disable credential caching
+ altogether.</para>
+ </listitem>
+
+ </itemizedlist>
+
+ <para>To disable caching for a single command, pass the
<option>--no-auth-cache</option> option:</para>
<screen>
@@ -1909,6 +1938,16 @@
jane = r
</screen>
+ <para>Groups can also be defined to contain other
+ groups:</para>
+
+ <screen>
+[groups]
+calc-developers = harry, sally, joe
+paint-developers = frank, sally, jane
+everyone = @calc-developers, @paint-developers
+</screen>
+
<para>...and that's pretty much all there is to it.</para>
</sect3>
Modified: trunk/src/ru/book/ch09.xml
==============================================================================
--- trunk/src/ru/book/ch09.xml (original)
+++ trunk/src/ru/book/ch09.xml Sat Jun 25 15:12:58 2005
@@ -6,7 +6,7 @@
@ENGLISH }}} -->
<title>Полное справочное руководство по Subversion</title>
<!-- See also svn.preface.organization -->
-
+
<!-- @ENGLISH {{{
<simplesect>
<para>This chapter is intended to be a complete reference to using
@@ -25,7 +25,7 @@
(<command>svnadmin</command> и <command>svnlook</command>) и
соответствующие им подкоманды.</para>
</simplesect>
-
+
<!-- ================================================================= -->
<!-- ======================== SECTION 1 ============================== -->
<!-- ================================================================= -->
@@ -33,7 +33,7 @@
<sect1 id="svn.ref.svn">
<title>The Subversion Command Line Client:
<command>svn</command></title>
-
+
<para>To use the command line client, you type
<command>svn</command>, the subcommand you wish to use
<footnote><para>Yes, yes, you don't need a subcommand to use the
@@ -47,7 +47,7 @@
<sect1 id="svn.ref.svn">
<title>Клиент командной строки Subversion:
<command>svn</command></title>
-
+
<para>Для того что бы воспользоваться клиентом, введите
<command>svn</command>, и желаемую подкоманду
<footnote><para>Да, да, вам не нужна подкоманда что бы задействовать
@@ -60,7 +60,7 @@
<screen>
$ svn -v status
-$ svn status -v
+$ svn status -v
$ svn status -v myfile
</screen>
@@ -68,10 +68,10 @@
<para>You can find many more examples of how to use most client
commands in <xref linkend="svn.tour"/> and commands for managing
properties in <xref linkend="svn.advanced.props"/>.</para>
-
+
<sect2 id="svn.ref.svn.sw">
- <title><command>svn</command> Switches</title>
-
+ <title><command>svn</command> Switches</title>
+
<para>While Subversion has different switches for its
subcommands, all switches are global—that is, each
switch is guaranteed to mean the same thing regardless of
@@ -84,10 +84,10 @@
может быть найдено в главе <xref linkend="svn.tour"/>. Команды
для управления свойствами описаны в главе
<xref linkend="svn.advanced.props"/>.</para>
-
+
<sect2 id="svn.ref.svn.sw">
- <title>Параметры <command>svn</command></title>
-
+ <title>Параметры <command>svn</command></title>
+
<para>Хотя Subversion имеет различные параметры для своих подкоманд,
все параметры глобальны. То есть, каждый параметр гарантированно
означает одно и тоже, в независимости от подкоманды с которой он
@@ -97,7 +97,7 @@
используете.</para>
<variablelist>
-
+
<!-- @ENGLISH {{{
<varlistentry>
<term><option>--><!--auto-props</option></term>
@@ -107,7 +107,7 @@
<filename>config</filename> file.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--><!--config-dir</option>
<replaceable>DIR</replaceable></term>
@@ -127,7 +127,7 @@
<filename>config</filename>.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--config-dir</option>
<replaceable>DIR</replaceable></term>
@@ -154,7 +154,7 @@
switch (more on that later in this section).</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--><!--diff3-cmd</option>
<replaceable>CMD</replaceable></term>
@@ -162,7 +162,7 @@
<para>Specifies an external program to use to merge files.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--><!--dry-run</option></term>
<listitem>
@@ -172,7 +172,7 @@
</listitem>
</varlistentry>
@ENGLISH }}} -->
-
+
<varlistentry>
<term><option>--diff-cmd</option>
<replaceable>CMD</replaceable></term>
@@ -189,7 +189,7 @@
(будет описан ниже в этой главе).</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--diff3-cmd</option>
<replaceable>CMD</replaceable></term>
@@ -198,7 +198,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--dry-run</option></term>
<listitem>
@@ -206,7 +206,7 @@
вносит изменений—ни на диске, ни в хранилище.</para>
</listitem>
</varlistentry>
-
+
<!-- @ENGLISH {{{
<varlistentry>
<term><option>--><!--editor-cmd</option>
@@ -216,7 +216,7 @@
or a property value.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--><!--encoding</option> <replaceable>ENC</replaceable></term>
<listitem>
@@ -251,7 +251,7 @@
комментария или свойства.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--encoding</option> <replaceable>ENC</replaceable></term>
<listitem>
@@ -277,7 +277,7 @@
параметром <option>--diff-cmd</option>.</para>
</listitem>
</varlistentry>
-
+
<!-- @ENGLISH {{{
<varlistentry>
<term><option>--><!--file</option> (<option>-F</option>)
@@ -303,7 +303,7 @@
you're doing, you're likely to get a nasty shock.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--><!--force-log</option></term>
<listitem>
@@ -320,8 +320,8 @@
operation, and that you simply failed to provide some
other—unversioned—file as the source of your log
message. To assert your intent and override these types
- of errors, pass the <option>--><!--force-log</option> option
- to commands that accept log messages.</para>
+ of errors, pass the <option>ﳢ-force-log</option> option
+ to subcommands that accept log messages.</para>
</listitem>
</varlistentry>
@ENGLISH }}} -->
@@ -349,7 +349,7 @@
делаешь, рискуешь "попасть под фазу".</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--force-log</option></term>
<listitem>
@@ -371,7 +371,7 @@
команд предполагающих ввод комментариев.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--help</option> (<option>-h</option> or
<option>-?</option>)
@@ -382,7 +382,7 @@
it displays the general client help text.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--ignore-ancestry</option></term>
<listitem>
@@ -390,7 +390,7 @@
differences (rely on path contents alone).</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--ignore-externals</option></term>
<listitem>
@@ -398,7 +398,7 @@
the external working copies managed by them.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--incremental</option></term>
<listitem>
@@ -406,7 +406,7 @@
concatenation.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--message</option> (<option>-m</option>)
<replaceable>MESSAGE</replaceable>
@@ -415,13 +415,13 @@
<para>Indicates that you will specify a commit message
on the command line, following this switch. For
example:</para>
-
+
<screen>
$ svn commit -m "They don't make Sunday."
</screen>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--new</option> <replaceable>ARG</replaceable></term>
<listitem>
@@ -429,7 +429,7 @@
target.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--no-auth-cache</option></term>
<listitem>
@@ -438,7 +438,7 @@
administrative directories.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--no-auto-props</option></term>
<listitem>
@@ -458,7 +458,7 @@
the file but removed all the content.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--no-ignore</option></term>
<listitem>
@@ -483,7 +483,7 @@
than to prompt for more information.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--non-recursive</option> (<option>-N</option>)</term>
<listitem>
@@ -498,7 +498,7 @@
<varlistentry>
<term><option>--notice-ancestry</option></term>
<listitem>
- <para>Pay attention to ancestry when calculating
+ <para>Pay attention to ancestry when calculating
differences.</para>
</listitem>
</varlistentry>
@@ -510,7 +510,7 @@
target.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--password</option>
<replaceable>PASS</replaceable></term>
@@ -521,7 +521,7 @@
it.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--quiet</option> (<option>-q</option>)</term>
<listitem>
@@ -529,7 +529,7 @@
information while performing an operation.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--recursive</option> (<option>-R</option>)</term>
<listitem>
@@ -537,7 +537,7 @@
Most subcommands recurse by default.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--relocate</option> <replaceable>FROM TO
[PATH...]</replaceable></term>
@@ -551,7 +551,7 @@
example.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--revision</option> (<option>-r</option>)
<replaceable>REV</replaceable>
@@ -577,7 +577,7 @@
information.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--revprop</option></term>
<listitem>
@@ -590,7 +590,7 @@
unversioned properties.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--show-updates</option> (<option>-u</option>)</term>
<listitem>
@@ -602,7 +602,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--stop-on-copy</option></term>
<listitem>
@@ -614,7 +614,7 @@
encountered.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--strict</option></term>
<listitem>
@@ -623,7 +623,7 @@
subcommands.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--targets</option>
<replaceable>FILENAME</replaceable></term>
@@ -634,7 +634,7 @@
</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--username</option>
<replaceable>NAME</replaceable></term>
@@ -645,7 +645,7 @@
it.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--verbose</option> (<option>-v</option>)</term>
<listitem>
@@ -656,7 +656,7 @@
additional information regarding its actions.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--version</option></term>
<listitem>
@@ -667,18 +667,18 @@
repository.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--xml</option></term>
<listitem>
<para>Prints output in XML format.</para>
</listitem>
</varlistentry>
-
+
</variablelist>
-
+
</sect2>
-
+
<sect2 id="svn.ref.svn.c">
<title><command>svn</command> Subcommands</title>
@@ -688,12 +688,12 @@
<refpurpose>Add files, directories, or symbolic links.</refpurpose>
</refnamediv>
<refsect1>
- <title>Synopsis</title>
+ <title>Synopsis</title>
<programlisting>svn add PATH...</programlisting>
</refsect1>
<refsect1>
<title>Description</title>
-
+
<para>Add files, directories, or symbolic links to your
working copy and schedule them for addition to the
repository. They will be uploaded and added to the
@@ -701,12 +701,12 @@
change your mind before committing, you can unschedule the
addition using <command>svn revert</command>.</para>
</refsect1>
-
+
<refsect1>
<title>Alternate Names</title>
<para>None</para>
</refsect1>
-
+
<refsect1>
<title>Changes</title>
<para>Working Copy</para>
@@ -716,7 +716,7 @@
<title>Accesses Repository</title>
<para>No</para>
</refsect1>
-
+
<refsect1>
<title>Switches</title>
@@ -730,20 +730,20 @@
--force
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
-
+
<para>To add a file to your working copy:</para>
<screen>
-$ svn add foo.c
+$ svn add foo.c
A foo.c
</screen>
<para>When adding a directory, the default behavior of
<command>svn add</command> is to recurse:</para>
-
+
<screen>
$ svn add testdir
A testdir
@@ -755,7 +755,7 @@
<para>You can add a directory without adding its
contents:</para>
-
+
<screen>
$ svn add --non-recursive otherdir
A otherdir
@@ -793,7 +793,7 @@
</refsect1>
<refsect1>
<title>Description</title>
-
+
<para>Show author and revision information in-line for the
specified files or URLs. Each line of text is annotated
at the beginning with the author (username) and the
@@ -857,7 +857,7 @@
</refsect1>
<refsect1>
<title>Description</title>
-
+
<para>Output the contents of the specified files or URLs.
For listing the contents of directories, see <command>svn
list</command>.</para>
@@ -913,13 +913,13 @@
<screen>
$ cat foo.c
-This file is in my local working copy
+This file is in my local working copy
and has changes that I've made.
$ svn cat foo.c
Latest revision fresh from the repository!
</screen>
-
+
</refsect1>
</refentry>
@@ -935,7 +935,7 @@
</refsect1>
<refsect1>
<title>Description</title>
-
+
<para>Check out a working copy from a repository. If
<replaceable>PATH</replaceable> is omitted, the
basename of the URL will be used as the
@@ -963,7 +963,7 @@
<refsect1>
<title>Switches</title>
-
+
<screen>
--revision (-r) REV
--quiet (-q)
@@ -975,7 +975,7 @@
--config-dir DIR
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
@@ -1160,11 +1160,11 @@
</refsect1>
-
+
<refsect1>
<title>Alternate Names</title>
- <para>ci (short for <quote>check in</quote>; not
- <quote>co</quote>, which is short for
+ <para>ci (short for <quote>check in</quote>; not
+ <quote>co</quote>, which is short for
<quote>checkout</quote>)</para>
</refsect1>
@@ -1204,7 +1204,7 @@
commit message on the command line and an implicit
target of your current directory
(<quote><filename>.</filename></quote>):</para>
-
+
<screen>
$ svn commit -m "added howto section."
Sending a
@@ -1248,7 +1248,7 @@
Committed revision 7.
</screen>
-
+
</refsect1>
</refentry>
@@ -1267,12 +1267,12 @@
<refsect1>
<title>Description</title>
-
+
<para>Copy a file in a working copy or in the repository.
<replaceable>SRC</replaceable> and
<replaceable>DST</replaceable> can each be either a
working copy (WC) path or URL:</para>
-
+
<variablelist>
<varlistentry>
@@ -1484,7 +1484,7 @@
--config-dir DIR
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
@@ -1516,15 +1516,15 @@
that has local mods:</para>
<screen>
-$ svn delete over-there
+$ svn delete over-there
svn: Attempting restricted operation for modified resource
svn: Use --force to override this restriction
svn: 'over-there' has local modifications
-$ svn delete --force over-there
+$ svn delete --force over-there
D over-there
</screen>
-
+
</refsect1>
</refentry>
@@ -1687,7 +1687,7 @@
diff</command>):</para>
<screen>
-$ svn diff COMMITTERS
+$ svn diff COMMITTERS
Index: COMMITTERS
===================================================================
--- COMMITTERS (revision 4404)
@@ -1698,7 +1698,7 @@
against an older revision:</para>
<screen>
-$ svn diff -r 3900 COMMITTERS
+$ svn diff -r 3900 COMMITTERS
Index: COMMITTERS
===================================================================
--- COMMITTERS (revision 3900)
@@ -1750,7 +1750,7 @@
differences without typing in the long URLs:</para>
<screen>
-$ svn diff -r 3000:3500 COMMITTERS
+$ svn diff -r 3000:3500 COMMITTERS
Index: COMMITTERS
===================================================================
--- COMMITTERS (revision 3000)
@@ -1761,16 +1761,16 @@
<replaceable>CMD</replaceable> <option>-x</option> to
pass arguments directly to the external diff
program</para>
-
+
<screen>
-$ svn diff --diff-cmd /usr/bin/diff -x "-i -b" COMMITTERS
+$ svn diff --diff-cmd /usr/bin/diff -x "-i -b" COMMITTERS
Index: COMMITTERS
===================================================================
0a1,2
> This is a test
->
+>
</screen>
-
+
</refsect1>
</refentry>
@@ -1897,7 +1897,7 @@
<para>This is your best friend when you're using
Subversion and this book isn't within reach!</para>
</refsect1>
-
+
<refsect1>
<title>Alternate Names</title>
<para>?, h</para>
@@ -2014,7 +2014,7 @@
<emphasis>not</emphasis> under version control. To start
working, you still need to <command>svn checkout</command>
a fresh working copy of the tree.</para>
-
+
</refsect1>
</refentry>
@@ -2110,7 +2110,7 @@
Last Changed Rev: 19
Last Changed Date: 2003-01-16 23:21:19 -0600 (Thu, 16 Jan 2003)
</screen>
-
+
</refsect1>
</refentry>
@@ -2373,10 +2373,10 @@
<screen>
$ svn log -r 14:15
------------------------------------------------------------------------
-r14 | ...
+r14 | ...
------------------------------------------------------------------------
-r15 | ...
+r15 | ...
------------------------------------------------------------------------
</screen>
@@ -2391,15 +2391,15 @@
$ svn log -r 27 >> mylog
$ cat mylog
------------------------------------------------------------------------
-r14 | ...
+r14 | ...
------------------------------------------------------------------------
------------------------------------------------------------------------
-r19 | ...
+r19 | ...
------------------------------------------------------------------------
------------------------------------------------------------------------
-r27 | ...
+r27 | ...
------------------------------------------------------------------------
</screen>
@@ -2414,13 +2414,13 @@
$ svn log --incremental -r 27 >> mylog
$ cat mylog
------------------------------------------------------------------------
-r14 | ...
+r14 | ...
------------------------------------------------------------------------
-r19 | ...
+r19 | ...
------------------------------------------------------------------------
-r27 | ...
+r27 | ...
</screen>
<para>The <option>--incremental</option> switch provides
@@ -2443,9 +2443,9 @@
that revision. If you log from the top of the
repository, or know the file that changed in that
revision, you can specify it explicitly:</para>
-
+
<screen>
-$ svn log -r 20 touched.txt
+$ svn log -r 20 touched.txt
------------------------------------------------------------------------
r20 | sally | 2003-01-17 22:56:19 -0600 (Fri, 17 Jan 2003) | 1 line
@@ -2559,12 +2559,12 @@
U myproj/thhgttg.txt
…
</screen>
-
+
<para>To merge changes to a single file:</para>
<screen>
$ cd myproj
-$ svn merge -r 30:31 thhgttg.txt
+$ svn merge -r 30:31 thhgttg.txt
U thhgttg.txt
</screen>
@@ -2647,7 +2647,7 @@
Committed revision 26.
</screen>
-
+
</refsect1>
</refentry>
@@ -2824,7 +2824,7 @@
<para>Delete a revision property:</para>
<screen>
-$ svn propdel --revprop -r 26 release-date
+$ svn propdel --revprop -r 26 release-date
property 'release-date' deleted from repository revision '26'
</screen>
@@ -2890,7 +2890,7 @@
modify properties that have multiple values:</para>
<screen>
-$ svn propedit svn:keywords foo.c
+$ svn propedit svn:keywords foo.c
<svn will launch your favorite editor here, with a buffer open
containing the current contents of the svn:keywords property. You
can add multiple values to a property easily here by entering one
@@ -2960,7 +2960,7 @@
<para>Examine a property of a file in your working
copy:</para>
-
+
<screen>
$ svn propget svn:keywords foo.c
Author
@@ -2971,10 +2971,10 @@
<para>The same goes for a revision property:</para>
<screen>
-$ svn propget svn:log --revprop -r 20
+$ svn propget svn:log --revprop -r 20
Began journal.
</screen>
-
+
</refsect1>
</refentry>
@@ -3029,7 +3029,7 @@
--config-dir DIR
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
@@ -3055,7 +3055,7 @@
svn:keywords : Author Date Rev
owner : sally
</screen>
-
+
</refsect1>
</refentry>
@@ -3130,7 +3130,7 @@
<para>Set the mimetype on a file:</para>
<screen>
-$ svn propset svn:mime-type image/jpeg foo.jpg
+$ svn propset svn:mime-type image/jpeg foo.jpg
property 'svn:mime-type' set on 'foo.jpg'
</screen>
@@ -3162,7 +3162,7 @@
<para>Or, if you don't have a working copy, you can
provide a URL.</para>
-
+
<screen>
$ svn propset --revprop -r 26 svn:log "Document nap." http://svn.red-bean.com/repos
property 'svn:log' set on repository revision '25'
@@ -3173,7 +3173,7 @@
property to something binary:</para>
<screen>
-$ svn propset owner-pic -F sally.jpg moo.c
+$ svn propset owner-pic -F sally.jpg moo.c
property 'owner-pic' set on 'moo.c'
</screen>
@@ -3239,10 +3239,10 @@
--config-dir DIR
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
-
+
<para>If you get a conflict on an update, your working
copy will sprout three new files:</para>
@@ -3397,12 +3397,12 @@
character wide, and each column gives you information
about different aspects of each working copy
item.</para>
-
+
<para>The first column indicates that an item
was added, deleted, or otherwise changed.</para>
<variablelist>
-
+
<varlistentry>
<term>' '</term>
<listitem>
@@ -3443,7 +3443,7 @@
<listitem>
<para>The contents (as opposed to the properties) of
the item conflict with updates received from the
- repository.</para>
+ repository.</para>
</listitem>
</varlistentry>
@@ -3457,7 +3457,7 @@
<varlistentry>
<term>'I'</term>
<listitem>
- <para>Item is being ignored (e.g. with the
+ <para>Item is being ignored (e.g. with the
<literal>svn:ignore</literal> property).</para>
</listitem>
</varlistentry>
@@ -3494,7 +3494,7 @@
directory's properties.</para>
<variablelist>
-
+
<varlistentry>
<term>' '</term>
<listitem>
@@ -3525,14 +3525,14 @@
working copy directory is locked.</para>
<variablelist>
-
+
<varlistentry>
<term>' '</term>
<listitem>
<para>Item is not locked.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term>'L'</term>
<listitem>
@@ -3544,16 +3544,16 @@
<para>The fourth column is populated only if the item is
scheduled for addition-with-history.</para>
-
+
<variablelist>
-
+
<varlistentry>
<term>' '</term>
<listitem>
<para>No history scheduled with commit.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term>'+'</term>
<listitem>
@@ -3568,14 +3568,14 @@
linkend="svn.branchmerge.switchwc"/>).</para>
<variablelist>
-
+
<varlistentry>
<term>' '</term>
<listitem>
<para>Item is a child of its parent directory.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term>'S'</term>
<listitem>
@@ -3590,14 +3590,14 @@
<option>--show-updates</option> switch).</para>
<variablelist>
-
+
<varlistentry>
<term>' '</term>
<listitem>
<para>The item in your working copy is up-to-date.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term>'*'</term>
<listitem>
@@ -3612,11 +3612,11 @@
delimited by spaces. The working revision is the next
field if the <option>--show-updates</option> or
<option>--verbose</option> switches are passed.</para>
-
+
<para>If the <option>--verbose</option> switch is passed,
the last committed revision and last committed author
are displayed next.</para>
-
+
<para>The working copy path is always the final field, so
it can include spaces.</para>
@@ -3769,7 +3769,7 @@
--config-dir DIR
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
@@ -3849,7 +3849,7 @@
understand exactly when one should or shouldn't use
<option>--relocate</option>. Here's the rule of
thumb:</para>
-
+
<itemizedlist>
<listitem><para>If the working copy needs to reflect a
new directory <emphasis>within</emphasis> the
@@ -4001,11 +4001,11 @@
single file, you may want to use <command>svn
cat</command>.</para>
</tip>
-
+
</refsect1>
</refentry>
</sect2>
-
+
</sect1>
<!-- ================================================================= -->
@@ -4013,7 +4013,7 @@
<!-- ================================================================= -->
<sect1 id="svn.ref.svnadmin">
<title><command>svnadmin</command></title>
-
+
<para><command>svnadmin</command> is the administrative tool for
monitoring and repairing your Subversion repository. For
detailed information, see <xref
@@ -4022,12 +4022,12 @@
<para>Since <command>svnadmin</command> works via direct repository access
(and thus can only be used on the machine that holds the
repository), it refers to the repository with a path, not a URL.</para>
-
+
<sect2 id="svn.ref.svnadmin.sw">
- <title><command>svnadmin</command> Switches</title>
-
+ <title><command>svnadmin</command> Switches</title>
+
<variablelist>
-
+
<varlistentry>
<term><option>--bdb-log-keep</option></term>
<listitem>
@@ -4035,7 +4035,7 @@
of database log files.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--bdb-txn-nosync</option></term>
<listitem>
@@ -4043,7 +4043,7 @@
committing database transactions.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--bypass-hooks</option></term>
<listitem>
@@ -4184,7 +4184,7 @@
<screen>
$ svnadmin create /usr/local/svn/repos
</screen>
-
+
<para>In Subversion 1.0, a Berkeley DB repository is always
created. In Subversion 1.1, a Berkeley DB repository is
the default repository type, but an FSFS repository can be
@@ -4224,7 +4224,7 @@
</refsect1>
<refsect1>
<title>Switches</title>
-
+
<screen>
--revision (-r)
--quiet
@@ -4271,7 +4271,7 @@
</refsect1>
<refsect1>
<title>Switches</title>
-
+
<screen>
--revision (-r)
--incremental
@@ -4279,7 +4279,7 @@
--deltas
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
@@ -4299,7 +4299,7 @@
repository:</para>
<screen>
-$ svnadmin dump /usr/local/svn/repos -r 21 --incremental
+$ svnadmin dump /usr/local/svn/repos -r 21 --incremental
* Dumped revision 21.
SVN-fs-dump-format-version: 1
Revision-number: 21
@@ -4365,7 +4365,7 @@
<refsect1>
<title>Switches</title>
-
+
<screen>
--clean-logs
</screen>
@@ -4427,7 +4427,7 @@
<refsect1>
<title>Examples</title>
-
+
<para>Remove all unused log files from a repository:</para>
<screen>
@@ -4464,7 +4464,7 @@
<refsect1>
<title>Switches</title>
-
+
<screen>
--quiet (-q)
--ignore-uuid
@@ -4529,7 +4529,7 @@
repository.</para>
<screen>
-$ svnadmin lstxns /usr/local/svn/repos/
+$ svnadmin lstxns /usr/local/svn/repos/
1w
1x
</screen>
@@ -4563,11 +4563,11 @@
</refsect1>
<refsect1>
<title>Examples</title>
-
+
<para>Recover a hung repository:</para>
<screen>
-$ svnadmin recover /usr/local/svn/repos/
+$ svnadmin recover /usr/local/svn/repos/
Repository lock acquired.
Please wait; recovering the repository may take some time...
@@ -4628,7 +4628,7 @@
<refsect1>
<title>Switches</title>
-
+
<screen>
--quiet (-q)
</screen>
@@ -4732,11 +4732,11 @@
<refsect1>
<title>Examples</title>
-
+
<para>Verify a hung repository:</para>
<screen>
-$ svnadmin verify /usr/local/svn/repos/
+$ svnadmin verify /usr/local/svn/repos/
* Verified revision 1729.
</screen>
@@ -4746,13 +4746,13 @@
</sect2>
</sect1>
-
+
<!-- ================================================================= -->
<!-- ======================== SECTION 3 ============================== -->
<!-- ================================================================= -->
<sect1 id="svn.ref.svnlook">
<title><command>svnlook</command></title>
-
+
<para><command>svnlook</command> is a command-line utility for
examining different aspects of a Subversion repository. It
does not make any changes to the repository—it's just
@@ -4768,10 +4768,10 @@
<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.ref.svnlook.sw">
<title><command>svnlook</command> Switches</title>
-
+
<para>Switches in <command>svnlook</command> are global, just
like in <command>svn</command> and
<command>svnadmin</command>; however, most switches only
@@ -4844,7 +4844,7 @@
<refsect1>
<title>Switches</title>
-
+
<screen>
--revision (-r)
--transaction (-t)
@@ -4858,9 +4858,9 @@
very exciting:</para>
<screen>
-$ svnlook author -r 40 /usr/local/svn/repos
+$ svnlook author -r 40 /usr/local/svn/repos
sally
-</screen>
+</screen>
</refsect1>
</refentry>
@@ -4895,7 +4895,7 @@
<title>Examples</title>
<para>This shows the contents of a file in transaction
- <literal>ax8</literal>, located at
+ <literal>ax8</literal>, located at
<filename>/trunk/README</filename>:</para>
<screen>
@@ -4913,7 +4913,7 @@
III. PARTICIPATING IN THE SUBVERSION COMMUNITY
…
</screen>
-
+
</refsect1>
</refentry>
@@ -4961,7 +4961,7 @@
A trunk/vendors/deli/sandwich.txt
A trunk/vendors/deli/pickle.txt
</screen>
-
+
</refsect1>
</refentry>
@@ -4990,14 +4990,14 @@
--transaction (-t)
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
-
+
<para>This shows the date of revision 40 of a test
repository:</para>
- <screen>
+ <screen>
$ svnlook date -r 40 /tmp/repos/
2003-02-22 17:44:49 -0600 (Sat, 22 Feb 2003)
</screen>
@@ -5024,7 +5024,7 @@
<refsect1>
<title>Switches</title>
-
+
<screen>
--revision (-r)
--transaction (-t)
@@ -5034,7 +5034,7 @@
<refsect1>
<title>Examples</title>
-
+
<para>This shows a newly added (empty) file, a deleted
file, and a copied file:</para>
@@ -5062,7 +5062,7 @@
Deleted: trunk/vendors/deli/pickle.txt
==============================================================================
</screen>
-
+
<para>If a file has a non-textual
<literal>svn:mime-type</literal> property, then the
differences are not explicitly shown.</para>
@@ -5106,7 +5106,7 @@
$ svnlook dirs-changed -r 40 /usr/local/svn/repos
trunk/vendors/deli/
</screen>
-
+
</refsect1>
</refentry>
@@ -5145,7 +5145,7 @@
</refnamediv>
<refsect1>
<title>Synopsis</title>
- <programlisting>svnlook history REPOS_PATH
+ <programlisting>svnlook history REPOS_PATH
[PATH_IN_REPOS]</programlisting>
</refsect1>
<refsect1>
@@ -5191,7 +5191,7 @@
2 /trunk <1.0.3>
1 /trunk <1.0.2>
</screen>
-
+
</refsect1>
</refentry>
@@ -5235,7 +5235,7 @@
15
Rearrange lunch.
</screen>
-
+
</refsect1>
</refentry>
@@ -5257,16 +5257,16 @@
<refsect1>
<title>Switches</title>
-
+
<screen>
--revision (-r)
--transaction (-t)
</screen>
</refsect1>
-
+
<refsect1>
<title>Examples</title>
-
+
<para>This shows the log output for revision 40 in our sample
repository:</para>
@@ -5274,7 +5274,7 @@
$ svnlook log /tmp/repos/
Rearrange lunch.
</screen>
-
+
</refsect1>
</refentry>
@@ -5381,7 +5381,7 @@
original-author : fitz
svn:mime-type : text/plain
</screen>
-
+
</refsect1>
</refentry>
@@ -5415,7 +5415,7 @@
<refsect1>
<title>Examples</title>
-
+
<para>This shows the tree output (with node-IDs) for revision
40 in our sample repository:</para>
@@ -5429,7 +5429,7 @@
soda.txt <1k.0.2j>
sandwich.txt <1j.0.2j>
</screen>
-
+
</refsect1>
</refentry>
@@ -5458,7 +5458,7 @@
<refsect1>
<title>Examples</title>
- <screen>
+ <screen>
$ svnlook uuid /usr/local/svn/repos
e7fe1b91-8cd5-0310-98dd-2f12e793c5e8
</screen>
@@ -5488,8 +5488,8 @@
<para>This shows the youngest revision of our sample
repository:</para>
- <screen>
-$ svnlook youngest /tmp/repos/
+ <screen>
+$ svnlook youngest /tmp/repos/
42
</screen>
@@ -5505,7 +5505,7 @@
<sect1 id="svn.ref.svnserve">
<title><command>svnserve</command></title>
-
+
<para><command>svnserve</command> allows access to Subversion
repositories using the <literal>svn</literal> network protocol.
You can run svnserve either as a standalone server process, or
@@ -5520,10 +5520,10 @@
authentication database to use and what authorization policies
to apply. See <xref linkend="svn.serverconfig.svnserve"/> for details of
the <filename>svnserve.conf</filename> file.</para>
-
+
<sect2 id="svn.ref.svnserve.sw">
<title><command>svnserve</command> Switches</title>
-
+
<para>Unlike the previous commands we've
described. <command>svnserve</command> has no
subcommands—<command>svnserve</command> is controlled
@@ -5662,7 +5662,7 @@
<sect1 id="svn.ref.svnversion">
<title><command>svnversion</command></title>
-
+
<refentry id="svn.ref.svnversion.re">
<refnamediv>
<refname>svnversion</refname>
@@ -5698,14 +5698,14 @@
has switches.</para>
<variablelist>
-
+
<varlistentry>
<term><option>--no-newline</option> (<option>-n</option>)</term>
<listitem>
<para>Omit the usual trailing newline from the output.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--committed</option> (<option>-c</option>)</term>
<listitem>
@@ -5713,14 +5713,14 @@
current (i.e., highest locally available) revisions.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--help</option> (<option>-h</option>)</term>
<listitem>
<para>Print a help summary.</para>
</listitem>
</varlistentry>
-
+
<varlistentry>
<term><option>--version</option></term>
<listitem>
@@ -5761,7 +5761,7 @@
4168M</screen>
<para>If the working copy is switched, a trailing "S" is
- added:</para>
+ added:</para>
<screen>$ svnversion .
4168S</screen>
@@ -5790,14 +5790,14 @@
<sect1 id="svn.ref.mod_dav_svn">
<title><command>mod_dav_svn</command></title>
-
+
<refentry id="svn.ref.mod_dav_svn.conf">
<refnamediv>
<refname><literal>mod_dav_svn</literal> Configuration
Directives</refname> <refpurpose>Apache configuration
directives for serving Subversion repositories through Apache
- HTTP Server.</refpurpose>
+ HTTP Server.</refpurpose>
</refnamediv>
@@ -5815,7 +5815,7 @@
<title>Directives</title>
<variablelist>
-
+
<varlistentry>
<term><literal>DAV svn</literal></term>
<listitem>
@@ -5920,7 +5920,7 @@
</chapter>
<!--
-local variables:
+local variables:
sgml-parent-document: ("book.xml" "chapter")
end:
vim: tw=78:ft=svnbook
Modified: trunk/src/ru/sync.py
==============================================================================
--- trunk/src/ru/sync.py (original)
+++ trunk/src/ru/sync.py Sat Jun 25 15:12:58 2005
@@ -12,10 +12,12 @@
-f: <filename.xml>
-a: <action>, can be [log | diff | merge]
-b: Merging ru/ with en/
+ -l: View log for en/book/
Examples:
%(name)s -f book/ch01.xml -a diff <- view diff for ch01.xml
%(name)s -b <- merging ru/ with en/
+ %(name)s -l <- view log for en/book/
""" % { 'name' : os.path.basename(sys.argv[0]) })
sys.exit(err_msg and 1 or 0)
@@ -25,12 +27,12 @@
usage(None)
try:
- opts, args = getopt.getopt(sys.argv[1:], "f:a:b")
+ opts, args = getopt.getopt(sys.argv[1:], "f:a:bl")
except:
usage("Invalid syntax")
fname = action = ''
- bmerge = False
+ bmerge = blog = False
book_src = os.listdir("book")
file_actions = ("log", "diff", "merge")
@@ -45,26 +47,44 @@
action = a
elif o == "-b":
bmerge = True
+ elif o == "-l":
+ blog = True
fd = open("LAST_UPDATED", "r")
last_up_rev = fd.readline()
fd.close()
attention = """ATTENTION! First it is necessary to make synchronization
-for separate files and commit performed changes!
+for separate files (and commit performed changes if during
+synchronization you had conflicts)!
Continue? [y/N] """
+ merge_error = """During merge there were some errors. Solve a problem
+and start merge once again."""
+
if bmerge:
if string.lower(raw_input(attention)) == 'y':
print "svn update"
os.system("svn update")
os.chdir("book")
- cmd = "svn merge" + " -r " + last_up_rev + ":" + "HEAD" + " " + \
+ cmd = "svn merge -r " + last_up_rev + ":HEAD " + \
book_src_url + "book/"
print cmd
os.system(cmd)
os.chdir("..")
os.system("svnversion . --no-newline > LAST_UPDATED")
+ fd = open("LAST_UPDATED", "r")
+ s = fd.readline()
+ fd.close()
+ if s != last_up_rev:
+ print merge_error
+ os.system("svn revert LAST_UPDATED")
+ sys.exit()
+
+ if blog:
+ cmd = "svn log -r " + last_up_rev + ":HEAD " + book_src_url + "book/"
+ print cmd
+ os.system(cmd)
sys.exit()
if fname == '' or action == '':
More information about the svnbook-dev
mailing list