[gentoo-doc-ru] Давно обещанное - комментарии к редактуре Азамата Хакимова

Как я обещал когда-то, разбираю первый редакторский опыт Азамата.

В целом все отлично, и я почти придираюсь ;-)



Ниже - diff с комментариями. Думаю, что будет полезно всем!





Спасибо, Азамат! (если, конечно, ты дочитал до сюда ;)

Буду рад и дальше видеть тебя в активных участниках!



Алексей Чумаков







--- D:\Cay\hobby\?\gentoo\gentoo-doc\doc\ru\handbook\hb-working-use.xml

2006-03-20 19:02:20.000000000 +0000

+++ hb-working-use.xml	2006-03-24 17:11:40.000000000 +0000

-<title>Суть USE-флагов</title>

+<title>Смысл USE-флагов</title>



Дело вкуса...





-Когда вы устанавливаете Gentoo (или любой другой дистрибутив, или даже

-операционную систему вообще), вы выбираете те или иные возможности в

зависимости

-от среды, с которой работаете. Установка сервера отличается от установки

рабочей

-станции, а установка игровой станции &mdash; от платформы 3D-рендеринга.

+Устанавливая Gentoo (или любой другой дистрибутив, или даже операционную 

+систему вообще), вы выбираете те или иные возможности в зависимости от

среды, с 

+которой работаете. Установка сервера отличается от установки рабочей

станции, а 

+установка игровой станции &mdash; от платформы 3D-рендеринга.



Лишние слова-связки "когда, который, было, будет" лучше устранять,

перефразируя

предложение.





 Это касается не только того, какие пакеты устанавливать, но и какие функции

-должны поддерживаться. Если вам не нужен OpenGL, то зачем вам его ставить

-и собирать поддержку OpenGL в большинстве программ? Если вы не собираетесь

-использовать KDE, зачем вам собирать пакеты с его поддержкой, если они

работают

-и без этого?

+определенных пакетов должны поддерживаться. Если вам не нужен OpenGL, то

зачем 

+вам его ставить и встраивать поддержку OpenGL в большинство программ? Если

вы 

+не собираетесь использовать KDE, зачем собирать пакеты с его поддержкой,

если 

+они работают и без этого?

 

Поправка в сторону оригинала; лишнее "вам"





 Чтобы помочь пользователям в выборе того, что устанавливать/активировать, а

что

-нет, мы предоставляем им простой способ описания рабочей среды. Это

позволяет

-пользователю решить, что же ему на самом деле надо и облегчить работу с

Portage,

-нашей системой управления пакетами.

+&mdash; нет, мы захотели дать им простой способ описания рабочей среды. Это



+позволяет пользователю решить, что же ему на самом деле надо, и облегчить 

+работу с Portage, нашей системой управления пакетами.



Тире.





-

-Рассмотрим USE-флаги. USE-флаг представляет собой ключевое слово,

описывающие

-поддержку и зависимости той или иной функции или концепции. Если вы

определяете

-какой-то USE-флаг, то Portage будет знать, что вы хотите активировать

поддержку

-данной функции. Конечно, это изменит также и информацию о зависимостях для

-пакета.

+Рассмотрим USE-флаги. USE-флаг &mdash; это ключевое слово, включающее

сведения 

+о поддержке и зависимостях определенного понятия или функции. При

определении

+какого-либо USE-флага, Portage узнает, что вам нужна поддержка

соответствующей

+функции. Конечно, это также влияет на сведения о зависимостях пакета.



Лишняя пустая строка удалена

Текст переведен ближе к оригиналу (см. первое предложение)



 

-Давайте рассмотрим конкретный пример &mdash; ключевое слово <c>kde</c>.

Если у

-вас нет этого слова в переменной <c>USE</c>, то все пакеты, где поддержка

KDE

-является <e>необязательной</e>, будут собраны <e>без</e> нее. Все пакеты,

где

-зависимость от KDE является <e>необязательной</e>, будут установлены

<e>без</e>

-установки библиотек KDE в качестве зависимости. Если же вы определили

ключевое

-слово <c>kde</c>, то эти пакеты будут собраны с поддержкой KDE, и KDE будет

-установлен как необходимая зависимость.

+Давайте рассмотрим конкретный пример &mdash; ключевое слово <c>kde</c>.

Если в

+вашей переменной <c>USE</c> нет этого слова, то все пакеты, где поддержка

KDE

+является <e>необязательной</e>, собрираются <e>без</e> нее. Все пакеты, где

+зависимость от KDE является <e>необязательной</e>, устанавливаются

<e>без</e>

+установки библиотек KDE (по зависимости). Если же вы определите ключевое

+слово <c>kde</c>, то эти пакеты будут собираться <e>с поддержкой</e> KDE, а

KDE 

+будет установлен в качестве необходимого.



Слова-паразиты "будут", чуть короче.





-Правильно определив ключевые слова, вы получите систему, собранную под ваши

-нужды.

+Правильно определяя ключевые слова, вы создаете систему, подогнанную

специально 

+для ваших нужд.



В оригинале - tailored



 

-<title>Какие существуют USE-флаги?</title>

+<title>Какие USE-флаги существуют?</title>



Построение фразы по-русски и по-английски иногда прямо противоположное





-Существует два типа USE-флагов: <e>глобальный</e> и <e>локальный</e>.

+Есть два типа USE-флагов: <e>глобальные</e> и <e>локальные</e>.



"Существуют" указано выше





     <e>Глобальный</e> USE-флаг используется несколькими пакетами и является

-    системным. Это и есть то, что видят большинство пользователей в

качестве

-    USE-флагов.

+    системным. Это то, что большинство видит в качестве USE-флагов.



Лишние слова





-    <e>Локальный</e> USE-флаг используется одним пакетом для каких-то

-    специфичных для него настроек.

+    <e>Локальный</e> USE-флаг используется единичным пакетом для настройки

+    определенных параметров самого пакета.



Все равно коряво, но мне показалось лучше.



 

 Список доступных глобальных USE-флагов можно найти <uri

 link="/dyn/use-index.xml">в сети</uri> или локально в

-<path>/usr/portage/profiles/use.desc</path>. Вот небольшая (<e>далеко</e>

не

-полная) выдержка:

+<path>/usr/portage/profiles/use.desc</path>.

 </p>

 

-<pre caption="Короткая выдержка из списка доступных USE-флагов">

-gtk     - поддержка x11-libs/gtk+ (The GIMP Toolkit)

-gtk2    - использовать gtk+-2.0 вместо gtk+-1.2 если программа поддерживает

оба

-gtkhtml - поддержка gnome-extra/gtkhtml

-guile   - поддержка dev-util/guile (интерпретатор для Scheme)

-icc     - использовать компилятор Intel C++ если пакет поддерживает его

-icc-pgo - включить генерацию данных PGO или использовать при использовании

icc

-imap    - поддержка протокола IMAP

-</pre>

 <p>

-Список локальных USE-флагов можно найти в

+Список локальных USE-флагов находится в вашей системе в

 <path>/usr/portage/profiles/use.local.desc</path>.

 </p>



Какой-то кусок случайно попал из более старой версии; удален



 

-<title>Использование USE-флагов.</title>

+<title>Использование USE-флагов</title>

-<title>Определение постоянных USE-флагов.</title>

+<title>Объявление постоянных USE-флагов</title>



Точки в заголовках не нужны





-Надеемся, что теперь у вас нет сомнений в необходимости USE-флагов, и мы

можем

-вам рассказать, как их установить.

+В надежде, что вы убедились в важности USE-флагов, теперь мы расскажем, как

их 

+объявлять.



Просто ближе к оригиналу





-Как было ранее сказано, все USE-флаги определяются в переменной <c>USE</c>.

-Чтобы упростить пользователям поиск и выбор флагов, мы предоставляем

настройки

-USE <e>по умолчанию</e>, которые представляют собой список USE-флагов,

которые,

-как нам кажется, наиболее часто используются пользователями Gentoo. Эти

-настройки прописаны в файле <path>make.defaults</path> вашего профиля.

+Как сказано ранее, все USE-флаги объявляются в переменной <c>USE</c>.

+Чтобы упростить пользователям поиск и выбор флагов, мы предлагаем значение

+USE <e>по умолчанию</e>, которое представляют собой список USE-флагов,

+как нам кажется, наиболее часто используемых пользователями Gentoo. Это

+значение приведено в файле <path>make.defaults</path> вашего профиля.



Здесь и часто далее слово setting надо переводить как "значение" а не как

"установка".



 

-Профиль вашей системы <path>/etc/make.profile</path> является

-символической ссылкой. Каждый профиль работает на основе предыдущего, более

-крупного, а в конце получается результат сложения всех профилей. Верхний

профиль

-является <path>базовым</path> (<path>/usr/portage/profiles/base</path>).

+Профиль, на который ориентируется ваша система, указывается символьной

ссылкой

+<path>/etc/make.profile</path>. Каждый профиль основывается на предыдущем, 

+более крупном, а итоговый складывается из всех профилей. Верхним является

+<path>базовый</path> профиль (<path>/usr/portage/profiles/base</path>).



Перефразировал ближе к оригиналу





-В качестве примера, мы уберем java из настроек USE на время установки

mozilla.

+Например, уберем java из значения USE на время установки mozilla.



Короче





-<pre caption="Запускаем emerge --info">

+<pre caption="Запуск emerge --info">



Заголовки лучше передавать так, а главное - однородно в документе





-Если вы изменили свои USE-фалги и хотите обновить всю систему под новое

значение

-USE, запустите <c>emerge</c> с опцией <c>--newuse</c>

+Если вы изменили свои USE-флаги и хотите обновить всю систему в

соответствии с 

+новым значением USE, запустите <c>emerge</c> с параметром <c>--newuse</c>:



Слово "опция" - ругательное; НЕ ОБСУЖДАЕТСЯ!



 

-<title>Специфичные для пакетов USE-флаги</title>

+<title>USE-флаги отдельных пакетов</title>



Слово specific тонко переводится: и как конкретный, и как определенный,

и как специфичный, и как просто "относящийся к ..."







-- 

gentoo-doc-ru@g.o mailing list