From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Message-ID: <41C80AB5.2090405@vzljot.ru> Date: Tue, 21 Dec 2004 14:36:21 +0300 From: Vitaly Ostanin User-Agent: Mozilla Thunderbird 0.9 (X11/20041103) X-Accept-Language: ru-ru, ru MIME-Version: 1.0 To: ALT Devel discussion list References: In-Reply-To: X-Enigmail-Version: 0.89.0.0 X-Enigmail-Supports: pgp-inline, pgp-mime Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="------------enig41E90892E440357A326FA68A" X-Virus-Scanned: by amavisd-new at vzljot.ru Subject: [devel] Re: xml2man X-BeenThere: devel@altlinux.ru X-Mailman-Version: 2.1.5 Precedence: list Reply-To: ALT Devel discussion list List-Id: ALT Devel discussion list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 21 Dec 2004 11:36:27 -0000 Archived-At: List-Archive: List-Post: This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --------------enig41E90892E440357A326FA68A Content-Type: multipart/mixed; boundary="------------070304090100020306000105" This is a multi-part message in MIME format. --------------070304090100020306000105 Content-Type: text/plain; charset=KOI8-R; format=flowed Content-Transfer-Encoding: 8bit йМШС еЧУЕЕЧ РЙЫЕФ: > чУЕН РТЙЧЕФ! > ч ЛБЛПН УПУФПСОЙЙ ОБИПДСФУС XSL-УФЙМЙ ДМС ФТБОУМСГЙЙ ЙЪ DocBook Ч man? > ч РТПЫМПН ЗПДХ ДЙУЛХУУЙС ЪБЛПОЮЙМБУШ ОБ ФПН, ЮФП ЕУФШ ОЕЮФП ЛТЙЧП-ХВПЗПЕ > Ч УБНПН DocBook Й ДПРПМОСАЭЙК ЕЗП man.xsl Ч УПУФБЧЕ уБНВЩ. с ВЩ ОЕ ОБЪЧБМ РЕТЧЩЕ ЛТЙЧП-ХВПЗЙНЙ. уХДС РП ФПНХ, ЮФП УБНВБ Ч НБО ФТБОУМЙТХЕФ, ФП ЧУЈ ПЛ. > уППФЧЕФУФЧЕООП, ЛПОЛТЕФОЩИ ЧПРТПУПЧ ФТЙ: > 1) РЕТЕУФБМ МЙ ./manpages/ Ч docbook-style-xsl-1.64.0-alt1 ВЩФШ ЛТЙЧЩН? > рП НПЙН ПЭХЭЕОЙСН, УЗЕОЕТЙТПЧБООБС ЙН man-УФТБОЙГБ > ЧЩЗМСДЙФ ОЕЛБЮЕУФЧЕООП (УН. dosbox-install Ч РБЛЕФЕ dosbox). ьФП ОЕЛПОЛТЕФОЩЕ ПЭХЭЕОЙС. > еУМЙ РЕТЕУФБМ, ФП РЙЫЕФ МЙ ЛФП-ОЙВХДШ man-УФТБОЙГЩ У ЕЗП РПНПЭША? > еУМЙ РЙЫЕФ, ФП Ч ЛБЛЙИ РБЛЕФБИ НПЦОП ЧЪЗМСОХФШ ОБ ПВТБЪГЩ? с РЙУБМ, ХЦЕ ДБЧОП, Ч РБЛЕФЕ ОЕФХ, ЕУФШ Ч БФФБЮЕ. > 2) еУМЙ ./manpages/ ФБЛ Й ПУФБМУС ЛТЙЧЩН, ФП ПРБЛЕЮЙЧБМ МЙ ЛФП-ОЙВХДШ man.xsl ЙЪ уБНВЩ? > 3) еУМЙ ОЕ ПРБЛЕЮЙЧБМ Й ОЕ УПВЙТБЕФУС, ФП ЕУФШ МЙ Х ОБУ XML packaging policy? > ч РТЙОГЙРЕ, ЕУМЙ ЪБЗМСОХФШ Ч РБЛЕФЩ alt-docs-xsl-*, ЧУЈ СУОП Й ВЕЪ ОЕЈ, > ОП ПОБ ВЩ, ЕУМЙ ДПКДХФ ТХЛЙ, ЧУСЛП ОЕ РПНЕЫБМБ. чЩ ЙНЕЕФЕ Ч ЧЙДХ XSL packaging policy ? оБУЛПМШЛП С ЪОБА - ОЕФ. х НЕОС Ч ВМЙЦБКЫЕЕ ЧТЕНС ТХЛЙ ФПЮОП ОЕ ДПКДХФ. й РПФПН ЕЭЈ ОЕ ДПКДХФ ДП ПРТЕДЕМЈООПЗП НПНЕОФБ :) -- Regards, Vyt mailto: vyt@vzljot.ru JID: vyt@vzljot.ru --------------070304090100020306000105 Content-Type: text/plain; name="xmllint.1" Content-Transfer-Encoding: 8bit Content-Disposition: inline; filename="xmllint.1" .\"Generated by db2man.xsl. Don't modify this, modify the source. .de Sh \" Subsection .br .if t .Sp .ne 5 .PP \fB\\$1\fR .PP .. .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Ip \" List item .br .ie \\n(.$>=3 .ne \\$3 .el .ne 3 .IP "\\$1" \\$2 .. .TH "XMLLINT" 1 "" "" "" .SH NAME xmllint \- консольная утилита для работы с XML .SH "Обзор" .nf \fBxmllint\fR [--version] [--debug] [--shell] [--debugent] [--copy] [--recover] [--noent] [--noout] [--htmlout] [--nowrap] [--valid] [--postvalid] [--dtdvalid \fIURL\fR] [--timing] [--repeat] [--insert] [--compress] [--sgml] [--html] [--push] [--memory] [--nowarning] [--noblanks] [--format] [--testIO] [--encode \fIencoding\fR] [--catalogs] [--nocatalogs] [--auto] [--xinclude] [--loaddtd] [--dtdattr] [--dropdtd] [\fIXML-файл\fR...] .fi .SH "Описание" .PP Программа xmllint обрабатывает один или несколько XML файлов, указанных в строке запуска как \fBXML-файл\fR\&. xmllint создаёт разные варианты вывода в зависимости от выбранных опций\&. Программа полезна для выявления ошибок в коде XML файла или в самом парсере\&. .PP xmllint является частью библиотеки libxml2: \fIhttp://xmlsoft.org\fR\&. .RS .Sh "Note" .PP Для перевода некоторых терминов XML используются русские переводы: \fIhttp://croll.hotbox.ru/W3C/Consortium/Translation/russian-ru.html\fR документов World Wide Web Consortium: \fIhttp://www.w3.org\fR (W3C)\&. .RE .SH "Опции" .TP \fB--version\fR Показать версию используемой библиотеки libxml2\&. .TP \fB--debug\fR Обработать файл и вывести с комментариями структуру представления документа в памяти\&. .TP \fB--shell\fR Запустить командную среду\&. Подробности о доступных командах среды описаны дальше\&. .TP \fB--debugent\fR Включить отладку сущностей (entities), указанных в документе\&. .TP \fB--copy\fR Тестировать реализацию внутреннего копирования\&. Как правило, просто копирует документ на стандартный вывод\&. .TP \fB--recover\fR Игнорировать мелкие ошибки в исходном документе\&. .TP \fB--noent\fR Заменять ссылки на сущности их значениями\&. По умолчанию xmllint оставляет в документе ссылки на сущности\&. Эта опция полезна вместе с \fB--postvalid\fR для проверки документов, или при использовании сущностей в значениях атрибутов\&. .TP \fB--noout\fR Отключает вывод\&. По умолчанию xmllint выводит результирующую структуру документа\&. .TP \fB--htmlout\fR Вывести результат в формате HTML\&. Добавляет в вывод необходимые HTML-теги, позволяющие просмотреть результирующий вывод в браузере\&. .TP \fB--nowrap\fR Не выводить начальное объявление HTML и завершающие теги\&. .TP \fB--valid\fR Проверить соответствие документа (validating) объявленному типу документа (например, DTD)\&. Можно явно указать тип документа для проверки с помощью опции \fB--dtdvalid\fR\&. По умолчанию xmllint также проверяет, что документ правильно сформирован (well-formed), то есть соответствует правилам разметки XML\&. .RS .Sh "Tip" .PP Полезно использовать эту опцию вместе с \fB--noout\fR, тогда проверочные сообщения не будут путаться с выводом самого документа\&. .RE Документы, объединённые с помощью опции \fB--xinclude\fR, нужно проверять опцией \fB--postvalid\fR\&. .TP \fB--postvalid\fR Проверить соответствие документа типу документа после его разбора и обработки\&. .TP \fB--dtdvalid \fIURL\fR\fR Проверять соответствие типу документа, указанному в \fIURL\fR\&. .TP \fB--timing\fR Выводить информацию о времени, затраченном на выполнение различных действий\&. .TP \fB--repeat\fR Повторить операцию 100 раз, используется для определения производительности\&. .TP \fB--insert\fR Тестировать вставку элементов (внутренний тест)\&. .TP \fB--compress\fR Включить gzip-сжатие вывода\&. .TP \fB--sgml\fR Использовать DocBook SGML парсер\&. Позволяет создавать в памяти представление документа, созданного в формате DocBook SGML, и обрабатывать его как созданный в XML\&. .TP \fB--html\fR Использовать HTML парсер\&. .TP \fB--push\fR Использовать ``push'' режим парсера\&. .TP \fB--memory\fR Обрабатывать в памяти\&. .TP \fB--nowarning\fR Не выводить предупреждающие сообщения (warnings)\&. .TP \fB--noblanks\fR Выбрасывать игнорируемые пробельные символы\&. .TP \fB--format\fR Форматировать результирующий вывод\&. .TP \fB--testIO\fR Тестировать возможности ввода/вывода\&. .TP \fB--encode \fIencoding\fR\fR Кодировать вывод в указанной кодировке\&. Кодировка в объявлении XML устанавливается автоматически\&. .TP \fB--catalogs\fR Использовать файлы каталогов (catalogs) из переменной \fISGML_CATALOG_FILES\fR\&. Иначе используется каталог по умолчанию -- \fI/etc/xml/catalog\fR\&. .TP \fB--nocatalogs\fR Не использовать любые каталоги\&. .TP \fB--auto\fR Вывести небольшой документ для тестирования\&. .TP \fB--xinclude\fR Обрабатывать включения документов по стандарту XML Inclusions (XInclude): \fIhttp://www.w3.org/TR/xinclude/\fR\&. По умолчанию xmllint не выполняет такие включения\&. .RS .Sh "Note" .PP В libxml2 до версии2\&.4\&.25 объединение большого количества документов требовало очень много ресурсов и времени\&. С версии 2\&.4\&.25 код включений серьёзно переписан и надобности в больших ресурсах нет\&. .RE .RS .Sh "Tip" .PP Для проверки документов, использующих включения, нужно пользоваться опцией \fB--postvalid\fR\&. .RE .TP \fB--loaddtd\fR Загрузить внешний тип документа\&. Эта опция полезна для разрешения сущностей, объявленных во внешнем типе документа, при объединении нескольких включаемых документов в один\&. .TP \fB--dtdattr\fR Загрузить внешний тип документа и построить дерево с унаследованными атрибутами\&. .TP \fB--dropdtd\fR Удалить объявление типа документа из вывода\&. .SH "Командная среда" .PP xmllint позволяет использовать интерактивный режим команд (опция \fB--shell\fR)\&. Команды интерактивного режима: .TP \fBbase\fR Показать XML базу узла\&. .TP \fBbye\fR Выйти из режима команд\&. .TP \fBcat node\fR Показать текущий узел, или указанный [node]\&. .TP \fBcd path\fR Перейти к указанному узлу, или к корневому, если узел [path] не указан\&. .TP \fBdir path\fR Сохранить информацию узла (пространство имён, атрибуты, содержимое)\&. .TP \fBdu path\fR Показать структуру поддерева от указанного [path] узла, или от текущего, если не указан\&. .TP \fBexit\fR Выйти из режима команд\&. .TP \fBhelp\fR Показать справку\&. .TP \fBfree\fR Показать информацию об использовании памяти\&. .TP \fBload name\fR Загрузить документ, указанный \fIname\fR\&. .TP \fBls path\fR Показать содержимое [path] или текущего каталога\&. .TP \fBpwd\fR Показать путь к текущему узлу\&. .TP \fBquit\fR Выйти из режима команд\&. .TP \fBsave name\fR Сохранить текущий документ с указанным [name] или с оригинальным именем\&. .TP \fBvalidate\fR Проверить документ на ошибки (соответствие объявленному типу, правильность XML)\&. .TP \fBwrite name\fR Записать текущий узел в файл с указанным \fIname\fR именем\&. .SH "Ссылки" .TP 3 \(bu Русские переводы: \fIhttp://croll.hotbox.ru/W3C/Consortium/Translation/russian-ru.html\fR документов World Wide Web Consortium: \fIhttp://www.w3.org\fR (W3C); .TP \(bu Сайт библиотеки libxml2: \fIhttp://xmlsoft.org\fR; .LP .SH AUTHORS John Fleck , Ziying Sherwin , Heiko Rupp . --------------070304090100020306000105-- --------------enig41E90892E440357A326FA68A Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (GNU/Linux) Comment: Using GnuPG with Thunderbird - http://enigmail.mozdev.org iD8DBQFByAq1XQgvvSRg+k4RAizSAJ4pkGj2xgyw329eEUtePunvQT1w5gCghFri 152F6Bjqbk+Q+y9SoRLDlGE= =+GGL -----END PGP SIGNATURE----- --------------enig41E90892E440357A326FA68A--