man
man-страницы Tcl/Tk: https://www.tcl-lang.org/man/
Unix Manual Pages
by Theo Verelst
man [-k] [-s {в некоторых системах} ] [section] page Команда man в Linux, Unix и под cygwin во всех версиях Windows, кроме небольших портативных, позволяет вам просматривать справочные страницы (в принципе) для всех команд в системе. Если бы мы хотели узнать, как работает команда «ps» (состояние процесса), мы бы набрали
man ps 9.0010и получите:
PS(1) CYGWIN PS(1) СИНТАКСИС ps [-aefls] [-u UID] ПАРАМЕТРЫ -а, --все показать процессы всех пользователей -е, --все показать процессы всех пользователей -ф, --полный показать идентификаторы процессов, ppids -х, --помощь вывести информацию об использовании и выйти -л, --длинный показать uid процессов, ppids, pgids, winpids -s, --резюме показать сводку процесса ....(и т. д) если мы не знаем параметры и использование определенной версии man, мы набираем на целевой машине:
man manчтобы получить справочную страницу самого man:
man(1) man(1) ИМЯ man - форматирование и отображение страниц интерактивного руководства manpath - определить путь пользователя для поиска man-страниц СИНТАКСИС man [-acdfFhkKtwW] [--path] [-m система] [-p строка] [-C config_file] [-M pathlist] [-P пейджер] [-S section_list] [раздел] имя ... ОПИСАНИЕ man форматирует и отображает интерактивные справочные страницы. Если указать сек- ции, человек смотрит только в этот раздел инструкции. имя обычно имя страницы руководства, которое обычно является именем команды, функция или файл. Однако, если имя содержит косую черту (/), то man интерпретирует его как спецификацию файла, так что вы можете сделать man ./foo.5 или даже man /cd/foo/bar.1.gz. См. ниже описание того, где человек ищет страницу руководства.файлы. ПАРАМЕТРЫ -C конфигурационный_файл Укажите файл конфигурации для использования; по умолчанию ... (и т. д)
Хорошая страница руководства, вероятно, содержит:
Обозначение раздела НАЗВАНИЕ команды с описанием СИНТАКСИС в общем формате возможные необязательные и символические или буквальные аргументы и их порядок ОПИСАНИЕ в удобочитаемой форме, краткое и краткое, что делает команда Доступные ВАРИАНТЫ, их точная форма в списке, а также краткое и сжатое описание каждого из них и их комбинаций. СМОТРИ ТАКЖЕ перекрестную ссылку на связанные командыи, возможно:
ОШИБКИ очевидно: известные ошибки или ограничения ПЕРЕМЕННЫЕ ОКРУЖАЮЩЕЙ СРЕДЫ, которые использует команда или на которые она влияет.Можно использовать
man -k <ключевое слово>для поиска по ключевому слову во всех заголовках справочных страниц и получения списка результатов для каждой строки. В таких строках использования было стандартно использовать <> как указывающие литералы, и как необязательные аргументы, и .
Чтобы это работало, необходимо инициализировать команду whatis, обновив базу данных man, возможно, с помощью вызова сценария:
/usr/sbin/makewhatisВ Linux я думаю, что это может быть /sbin/makewhatis, доступный, вероятно, только для root.
В cygwin для Windows, где все это работает, страницы руководства по tcl/tk недоступны автоматически, если вы установили собственный TCL/TK. В Cygwin в настоящее время, я думаю, установлено Wish8.3 или около того, и для них есть возможные справочные страницы, но это не обязательно будет для вашей версии, что может быть обманчивым.
Кроме того, под Windows XX tcl / tk поставляется не с руководством в формате man, а только с скомпилированным форматом файла справки окна (или что-то еще, размер шрифта которого, к сожалению, не может быть установлен отдельно (раздражает при работе на рабочей станции 1600x1200, например, установка хочет, чтобы некоторые вещи были маленькими) насколько это возможно, и справочная страница в удобном для чтения, не напрягающем глаза размере).
Можно получить файлы Linux для той же версии и установить их в /cygdrive/c/cygwin/usr/man/mann или что-то в этом роде.
Человек концептуально представляет собой объединение двух программ, управляемых базой данных, сначала средство форматирования, обычно nroff (см. страницу руководства по unix/linux), а затем пейджер, обычно вариант «больше» (или «меньше»), которые отображают входной текст по одной странице терминала за раз, с шагом
для перехода на новый экран, для прокрутки на одну строку и для перехода на одну страницу назад (если доступно, невозможно для потокового ввода): nroff -man /somepath/somemanualpage.n | подробнееЧто все это значит для жителей Windows? Среди Tcl'еров принято говорить, что «это на странице руководства» означает «то, что вы ищете, появляется в стандартной документации, которая появляется в дистрибутиве Tcl». В Unix, как описано выше, каноническая установка делает эту стандартную документацию видимой через man COMMAND.
Tcllib содержит doctools как один из способов написания документации, которую затем можно преобразовать в формат справочной страницы (а также другие).
См. также Небольшой просмотрщик справочных страниц, а также tkman.
LV TkMan — замечательный инструмент, если вы все настроите. Обязательно установите вспомогательные инструменты, чтобы сделать его максимально мощным.TV (28 июня 2004 г.) Я создаю страницу с комментариями для man-страниц Tcl/Tk.
LV Не знаю, зачем столько вариаций на эту тему. Мне кажется, надо выбрать одну из них, туда переместить содержимое остальных страниц, а потом ссылки на остальные страницы поменять на одна страница, чтобы править их все ... так сказать.
файлы.
ПАРАМЕТРЫ
-C конфигурационный_файл
Укажите файл конфигурации для использования; по умолчанию
... (и т. д)
.. как возможное повторение.
0003
Стандартная документация присутствует и под Windows, даже при отсутствии Cygwin, но там проще всего получить доступ через [опишите, как перейти к Tcl Help].| Категория Command | Глоссарий категорий | Документация по категориям |
TK Men General – Местные контексты
Слушать
К сожалению, ваш браузер не поддерживает этот тип звука.
Пример
TK Men General (TK MG)
Зачем использовать этот ярлык?
Этот ярлык следует использовать, если вы хотите, чтобы внешние пользователи знали, что циркулирующие материалы должны распространяться только между мужчинами в сообществе. Это общий ярлык для мужчин, который указывает на то, что существуют ограничения доступа и использования для мужчин на основе обычного права. Эта этикетка может использоваться, чтобы помочь внешним пользователям понять, что для этого материала существуют определенные протоколы и условия использования. Этот ярлык предназначен для признания того, что некоторые знания имеют гендерную принадлежность и что определенные знания могут быть переданы только определенным членам сообщества. Его следует использовать для дополнения уже существующих обычаев и протоколов доступа и использования.
Каждая метка предназначена для индивидуальной настройки сообществом. См.
ниже текст шаблона этикетки.
TK Label Template Text
Доступ к этому материалу ограничен по признаку пола. Обычно к нему имеют доступ и используют только мужчины в сообществе. Если вы не являетесь членом сообщества и получили доступ к этому материалу, вас просят не загружать, копировать, ремикшировать или иным образом распространять этот материал среди других без разрешения. Эта этикетка призывает вас подумать о том, следует ли вам использовать этот материал, и уважать различные культурные ценности и ожидания в отношении распространения и использования.
Испанский / Испанский
CT Hombres General (CT HG)
Por qué usar esta CT etiqueta?
Esta etiqueta debiera usarse para informar a usuarios externos que el material circulante tiene restricciones de acceso y uso basado en leyes de costumbre, y que sólo debiera ser accedido, usado y compartido entre hombres de una misma comunidad. Esta etiqueta ha sido diseñada para informar que ciertos tipos de conocimiento poseen restrictiones de género, y que por ende, solamente pueden ser accedidos y utilizados por miembros específicos de una de una comunidad – en este caso, solo hombres.
Esta etiqueta ayuda a que usuarios externos a la comunidad se informen acerca de las costumbres y protocolos Culturales Existentes de acceso y uso de este material.
Texto de ejemplo
Esta etiqueta indica que el material circulante se rige por restricciones de género específicas y sólo debiese ser accedido y usado por hombres miembros de una comunidad. Si Usted не эс miembro де ла comunidad де origen у ха accedido Эсте материал, се ле ходатайство не descargarlo, copiarlo, mezclarlo о difundirlo грех авторизации. Esta etiqueta le pide evaluar si usted tiene derecho a utilizar este material y a la vez respetar los diferentes valores cultureles y expectativas sobre la circulación y uso de este material.
Французский / французский
ST Общий для мужчин (ST GH)
Pourquoi utiliser cette étiquette de ST?
Cette etiquette devrait être utilisée lorsque vous souhaitez informer les utilisateurs externes que le matériel qui est diffusé ne devrait être partage qu'entre les hommes de la communauté.
Cette etiquette d’generalisation des hommes indique que l’accès et l’utilization sont reservés aux hommes de la communauté sur la base des coutumes de la communauté. Cette étiquette peut être utilisée pour aider les utilisateurs externes à reconnaitre que ce matériel comporte des протоколы и des специальные условия использования. Elle reconnait la nature genrée de surees connaissances qui ne peuvent être partagées qu'entre des membres specifiques de la communauté. Cette etiquette devrait être utilisée en complément de coutumes et de protocoles d’accès et d’utilization qui sont déjà en vigueur.
Chaque etiquette devrait être personnalisée par la communauté. Cliquez plus bas pour obtenir un modele de texte pour cette etiquette.
Modele de texte des etiquettes de ST
Материал, содержащий ограничения доступа к естественному жанру. Generalement, seuls les hommes de la communauté y ont accès et peuvent l'utiliser. Si vous n'êtes pas un membre de la communauté et que vous avez accès à ce matériel, по вашему требованию de ne pas télécharger, копировальный аппарат, remixer или диффузор ce matériel de quelque façon que ce soit sans autorisation préalable.