Как я обещал когда-то, разбираю первый редакторский опыт Азамата. В целом все отлично, и я почти придираюсь ;-)
Ниже - 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 (или любой другой дистрибутив, или даже -операционную систему вообще), вы выбираете те или иные возможности в зависимости -от среды, с которой работаете. Установка сервера отличается от установки рабочей -станции, а установка игровой станции — от платформы 3D-рендеринга. +Устанавливая Gentoo (или любой другой дистрибутив, или даже операционную +систему вообще), вы выбираете те или иные возможности в зависимости от среды, с +которой работаете. Установка сервера отличается от установки рабочей станции, а +установка игровой станции — от платформы 3D-рендеринга. Лишние слова-связки "когда, который, было, будет" лучше устранять, перефразируя предложение. Это касается не только того, какие пакеты устанавливать, но и какие функции -должны поддерживаться. Если вам не нужен OpenGL, то зачем вам его ставить -и собирать поддержку OpenGL в большинстве программ? Если вы не собираетесь -использовать KDE, зачем вам собирать пакеты с его поддержкой, если они работают -и без этого? +определенных пакетов должны поддерживаться. Если вам не нужен OpenGL, то зачем +вам его ставить и встраивать поддержку OpenGL в большинство программ? Если вы +не собираетесь использовать KDE, зачем собирать пакеты с его поддержкой, если +они работают и без этого? Поправка в сторону оригинала; лишнее "вам" Чтобы помочь пользователям в выборе того, что устанавливать/активировать, а что -нет, мы предоставляем им простой способ описания рабочей среды. Это позволяет -пользователю решить, что же ему на самом деле надо и облегчить работу с Portage, -нашей системой управления пакетами. +— нет, мы захотели дать им простой способ описания рабочей среды. Это +позволяет пользователю решить, что же ему на самом деле надо, и облегчить +работу с Portage, нашей системой управления пакетами. Тире. - -Рассмотрим USE-флаги. USE-флаг представляет собой ключевое слово, описывающие -поддержку и зависимости той или иной функции или концепции. Если вы определяете -какой-то USE-флаг, то Portage будет знать, что вы хотите активировать поддержку -данной функции. Конечно, это изменит также и информацию о зависимостях для -пакета. +Рассмотрим USE-флаги. USE-флаг — это ключевое слово, включающее сведения +о поддержке и зависимостях определенного понятия или функции. При определении +какого-либо USE-флага, Portage узнает, что вам нужна поддержка соответствующей +функции. Конечно, это также влияет на сведения о зависимостях пакета. Лишняя пустая строка удалена Текст переведен ближе к оригиналу (см. первое предложение) -Давайте рассмотрим конкретный пример — ключевое слово <c>kde</c>. Если у -вас нет этого слова в переменной <c>USE</c>, то все пакеты, где поддержка KDE -является <e>необязательной</e>, будут собраны <e>без</e> нее. Все пакеты, где -зависимость от KDE является <e>необязательной</e>, будут установлены <e>без</e> -установки библиотек KDE в качестве зависимости. Если же вы определили ключевое -слово <c>kde</c>, то эти пакеты будут собраны с поддержкой KDE, и KDE будет -установлен как необходимая зависимость. +Давайте рассмотрим конкретный пример — ключевое слово <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@gentoo.org mailing list