LINUX.ORG.RU

man-pages 4.13

 , ,


0

1

Ментейнер проекта Майкл Керриск анонсировал версию 4.13 коллекции страниц руководства man для Linux.

Как указывает Майкл, в процесс подготовки данной версии внесли вклад около 40 участников; было сделано суммарно более 350 изменений, среди которых можно отметить добавление пяти страниц; кроме того, все 1028 существующих страницы претерпели различные правки.

Краткий обзор изменений:

  • Добавлена документация, касающаяся некоторых ранее не документированных аспектов реализации POSIX threads API:
    • Добавлены страницы pthread_mutexattr_setrobust(3) и pthread_mutex_consistent(3), описывающие часть API POSIX threads, относящуюся к поддержке robust mutexes. Кроме того, внесён ряд дополнений в страницу get_robust_list(2), описывающую системный вызов, используемый для реализации данной части API. Данные страницы написаны Майклом в соавторстве с Yubin Ruan.
    • Добавлена страница pthread_mutexattr_init(3), описывающая функции pthread_mutexattr_init() и pthread_mutexattr_destroy().
    • Добавлена страница pthread_mutexattr_getpshared(3), описывающая функции pthread_mutexattr_getpshared() и pthread_mutexattr_setpshared().
  • Добавлена страница sysfs(5), где положено начало документированию виртуальной файловой системы sysfs. На данном этапе файлы данной ФС документированы далеко не полностью, в связи с чем патчи с её дополнениями всячески приветствуются.
  • Документированы команды системного вызова fcntl(2) по управлению предположениями о режимах чтения/записи, добавленные в Linux 4.13: F_GET_RW_HINT, F_SET_RW_HINT, F_GET_FILE_RW_HINT и F_SET_FILE_RW_HINT.
  • В страницу документации команд системного вызова ioctl(2) по управлению терминалом внесена информация о команде TIOCGPTPEER.
  • В страницу документации системного вызова kcmp(2) внесена информация о команде KCMP_EPOLL_TFD, добавленной в Linux 4.13.
  • В страницу документации системного вызова keyctl(2) внесена информация о команде KEYCTL_RESTRICT_KEYRING и поддержке указания параметров KDF в команде KEYCTL_DH_COMPUTE, добавленных в Linux 4.12.

>>> Скачать

>>> Репозиторий

>>> История изменений

>>> Страница проекта

★★

Проверено: Shaman007 ()

в процесс подготовки данной версии внесли вклад около 40 участников;

ЛОРовцы не затесались среди них?

UVV ★★★★★ ()
Ответ на: комментарий от UVV

Ну, я писал ему с указанием на одно расхождение с реальностью в документации SIGCHLD, но он не отреагировал. Возможно, стоит переслать.

intelfx ★★★★★ ()
Ответ на: комментарий от WereFox

что-то не так пошло и не поднялся сетевой интерфейс

Ман поможет тебе поднять сеть?

wlauser ()

Добавлены страницы pthread_mutexattr_setrobust(3) и pthread_mutex_consistent(3), описывающие часть API POSIX threads, относящуюся к поддержке robust mutexes.

По ссылке:

A description of what robust futexes are

Сначала подумал: опечатка, потом стало ясно - это они так хитро закрутили:

To solve such types of problems, «robust mutex» userspace APIs were created

gag ★★★★★ ()
Ответ на: комментарий от gag

futex — fast userspace mutex, сокращение для названия системного вызова futex(2), равно как и интерфейса, им предоставляемого.

eSyr ★★ ()
Последнее исправление: eSyr (всего исправлений: 1)

350 изменений

то есть разница почти незаметна будет...

Einstok_Fair ★★☆ ()
Ответ на: комментарий от intelfx

Майкл довольно нерегулярно читает почту, лучше перепослать, ещё лучше присылать сразу патч (с cc в linux-man).

eSyr ★★ ()
Ответ на: комментарий от wlauser

П в интернете они откуда браться будут. Вот пишут. Можно смотреть онлайн, можно читать из локальных файлов.

saahriktu ★★★★★ ()
Ответ на: комментарий от wlauser

А интернет как, по-твоему, будет разбираться в вопросе, чтобы помочь тебе? Правильно, путем чтения манов.

anonymous ()
Ответ на: комментарий от wlauser

Акутальны они на сегодняшний день, когда для справки есть веб?

Тот же ман более удобочитаем в браузере.

Так актуальны или нет? Веб или браузер? Не говоря уже о том, что на том же man7.org очевидно текстовый рендер groff, разве что с добавлением ссылок (которые, например, pinfo точно так же распознаёт), все другие различия можно отнести разве что к недостаткам в настройке собственного терминала и рендера groff.

eSyr ★★ ()
Ответ на: комментарий от anonymous

Я клоню к тому, что я совсем не против иксов на сервере.

wlauser ()
Ответ на: комментарий от wlauser

Маны читают не когда а-а-а! а-а-а! всё сломалось! нужно срочно чинить!

Уже после того, как всё это пройдёт, ты составляешь список манов к прочтению, а в выбранное время садишься и читаешь их от начала и до конца.

i-rinat ★★★★★ ()
Ответ на: комментарий от wlauser

При серьезной проблеме

Что ты считаешь серьезной проблемой?

Интернет тебе поможет, если ты вообще ни в зуб ногой в данной теме, тогда он даст тебе необходимый старт. В остальном достаточно манов

anonymous ()
Ответ на: комментарий от wlauser

Не во всем, но большую часть помощи я таки получаю из манов, а не из «интернета», в отличие от тебя.

anonymous ()
Ответ на: комментарий от wlauser

Есть люди, которые не понимают. Среди них есть те, кто упорствует в своём непонимании. А уже среди этих встречаются такие, кто своё непонимание желает навязать другим.

Короче — язабан.

anonymous ()
Ответ на: комментарий от wlauser

При серьезной проблеме ман тебе не поможет. Надо гуглить. Вот и все.

ksh не возвращает предыдущую команду по нажатию ВВЕРХ

найдите мне, плиз, решение этой проблемы *в интернете* :)

а в man это находится элементарно - если, конечно, его читать

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

buratino ★★★★★ ()
Ответ на: комментарий от wlauser

ну используйте, в чем проблема то? судя по тому, что вам нужна отдельная вкладка с переводчиком, вы даже английский хотя б на уровне достаточном для чтения документации не осилили. о каком прогрессе можно тут говорить?

anonymous ()

Желаю много-много добра этим людям.

Я вот понимаю, как можно for fun писать программы (и сам этим иногда грешу). Но писать for fun документацию... Уважаю.

hobbit ★★★★★ ()
Ответ на: комментарий от anonymous

вы даже английский хотя б на уровне достаточном для чтения документации не осилили

Осилил, но незнакомые слова все равно попадаются.

wlauser ()
Ответ на: комментарий от hobbit

Удваиваю... Нет, утраиваю... Нет, пожалуй возвожу в степень!

Pinkbyte ★★★★★ ()
Ответ на: комментарий от wlauser

Помнится ты начал с того что поставил вопрос о нужности манов

MrClon ★★★★★ ()
Ответ на: комментарий от hobbit

Я вот понимаю, как можно for fun писать программы (и сам этим иногда грешу). Но писать for fun документацию... Уважаю.

Присоединяюсь!!!

anc ★★★★★ ()
Ответ на: комментарий от hobbit

Но писать for fun документацию...

А надо... И вообще, в свободной разработке вечно свободный разброд и шатание. На POSIX дружно болт кладут, а вспоминают, когда надо писать под весь цирк разом.

В проприетарщине, впрочем, то же самое, только код закрыт, продукт платен, а маркетолог, красиво заливающий про супер-пупер-мега-гипер-триппер-сикси-крутой воркинг внутри компании, просто гарантирующий фантастический выхлоп (а кто этого не понял, тот — упоротый опенсурцодрочер), получает столько же, сколько весь отдел разработки вместе взятый. Естественно, всем становится похрен на продукт.

Я за то, чтобы чётко и железобетонно прописывать в документации идеологию для целого класса ПО. Кому надо, пусть ныряют под крыло этой идеологии. Надо «развитие» — пусть рождают описание другой концепции, а не как сейчас, когда пишется что-то свер-ультра-современное, а документации нет даже на странице гитхаба разработчика, зато старейшая альтернатива — «сосёт», а кто этого не понял, тот — «замшелый пень»)

krotozer ()
Ответ на: комментарий от wlauser

Нет.

Да и зачем открывать монструзный браузер, когда быстрее и удобнее почитать локально?

shell-script ★★★★★ ()

Здравствуйте! Доброе утро! Добрый день! Добрый вечер! Saluton! Салем! 你好! Guten morgen! Guten tag! Hello! Good morning! Hi! Bonjour!

Спасибо! Большое спасибо! Спаси Бог! Спаси Господи! Благодарю! Dankon! Thank you! Рахмет! Merci! Merci beaucoup! Thanks!

:-)

anonymous ()
Вы не можете добавлять комментарии в эту тему. Тема перемещена в архив.