LINUX.ORG.RU

man-pages 4.10

 , , ,


0

2

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

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

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

  • Страницы add_key(2), keyctl(2) и request_key(2), описывающие системные вызовы для работы с подсистемой хранения криптографических ключей были существенно переработаны и расширены.
  • При содействии Дэвида Хоуэллса, разработчика подсистемы хранения криптографических ключей и библиотеки libkeyutils, ряд страниц руководства был перенесён в проект man-pages, так как они описывают ядерный интерфейс: keyrings(7), persistent-keyring(7), process-keyring(7), session-keyring(7), thread-keyring(7), user-keyring(7), user-session-keyring(7). Многие из них были обновлены и дополнены в процессе переноса.
  • Добавлена страница ioctl_iflags(2), которая описывает флаги inode (атрибуты, которыми позволяет манипулировать команда chattr(1)) и команда ioctl(2) для работы с этими флагами.
  • Детали команд ioctl(2) для работы с пространствами имён объектов (namespaces) вынесены из namespaces(7) в отдельную страницу ioctl_ns(2).
  • Добавлена страница getentropy(3), описывающая одноимённую библиотечную функцию, добавленную в glibc 2.25.
  • Описание использования функций, которые можно вызывать из обработчика сигнала, перенесено из signal(7) в отдельную страницу signal-safety(7). В процессе также были добавлены некоторые детали, такие как отличия glibc от того, что указано в POSIX.

>>> Скачать

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

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

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



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

Так держать!

anonymous ()

Так, а где этот ушибленный koi8, который обгадился в talks пытаясь сделать из этого события новость? Пусть учится, как надо.

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

Я не настолько болен разными соцсетями чтобы тратить столько времени на переводы и форматирования.

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

saahriktu ★★★★ ()

внесли вклад более 40 участников

40 целых и тринадцать сотых. А как же миф о миллионах учавствующих по всему миру?

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

Не знаю, где там миллионы участвующих, наверное в состемд с пшшшаудио добавляют новые фичи или пилят очередной js-фреймворк, но man-pages Керриск тащит фактически единолично (за что, да и не только за это, безграничные слава ему, почёт и уважение). Не было бы его, с документированностью Linux API было бы ощутимо хуже.

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

man-pages Керриск тащит фактически единолично

Всегда думал что каждый разраб к своему коду сам пишет. Или он именно про ядро и связанные подсистемы?

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

«The Linux man-pages project documents the Linux kernel and C library interfaces that are employed by user-space programs. With respect to the C library, the primary focus is the GNU C library (glibc), although, where known, documentation of variations on other C libraries available for Linux is also included.» — https://www.kernel.org/doc/man-pages/

eSyr ()

В процессе также были добавлены некоторые детали, такие как отличия glibc от того, что указано в POSIX.

вот это хорошо, а то зачастую сталкиватся приходится и сравнивать с manpages-posix-dev

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

прямым текстом писали, что никакие маны они никогда не читают

Да ладно врать-то, палишься ведь: тебе прямым текстом написали, что твой убогое изложение полно дебильных пассажей вроде того, сколько байт занял чейнджлог - соответственно всем насрать на такие подробности и такую «новость». С манами как раз всё в порядке и новость сама по себе интересная - просто ты скучный задрот, не умеющий общаться с людьми.

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

Любые дополнительные слова не отменяют саму новость. Если бы люди ждали обновления манов, то у них был бы повод для радости независимо от дополнительных комментариев. Но, суровая правда в том, что сами маны почти никому не нужны.

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

сами маны почти никому не нужны

Вот 4.2 так 4.2. Прям эталонное.

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

Любые дополнительные слова не отменяют саму новость.

Не льсти себе - порождённый тобой высер это даже близко не новость. Ещё раз, для тугих, не пытайся так отчаянно выгораживать своё чсв и перекладывать с больной головы на здоровую. С людьми всё в порядке, и с манами тоже. Суровая правда в том, что ты не можешь внятно написать даже один абзац текста.

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

Новость в самом релизе новой версии манов.

Интересно, как называется этот синдром в психологии?

zabbal ()
Ответ на: Срочно! от newprikolist

Перевести на русский язык.

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

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

Нахрена, не нахрена, а man-pages-ru всё еще существует, хоть и выкинуто из дебиана. Ну и без них локализаций у меня часть страниц на всяких языках, плюс еще достаточно отдельных пакетов с локализациями лежат в репозитории и не потеряли сопровождающих. Странно, что ru вылетел, я что-то это упустил — вот видать мне не нужно, я даже не заметил.

mandala ★★ ()
Последнее исправление: mandala (всего исправлений: 1)
Ответ на: комментарий от NextGenenration

Офигеть. А откуда изначально люди берут знания, из вдумчивого чтения исходников только? Если говорить про остальную сеть — так добрая половина решений является вольным пересказом этих самых руководств, и только небольшая часть выходит за их рамки.

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

Это ж не книжка какая-нибудь, а постоянно обновляемая рабочая документация.

А вот яркий пример

https://www.freedesktop.org/software/systemd/man/systemd.html
https://www.opennet.ru/man.shtml?topic=systemd&category=1&russian=0

Шесть лет, различия видны даже без знания языка.

Основная проблема, то что переводы не поддерживаются: делают их в основном для себя, для изучения языка и инструмента — достигнув цели бросают. Вторая — фрагментированность.

Но считаю имеет смысл перевод основных страниц и страниц базовых инструментов. В локализациях, в принципе, так оно и получается. Про веб-ресурсы: жаль мало где висят предупреждения о том, что документ устарел.

mandala ★★ ()
Последнее исправление: mandala (всего исправлений: 1)
Ответ на: комментарий от mandala

Но считаю имеет смысл перевод основных страниц и страниц базовых инструментов.

Зачем? Не, в случае с «делают их в основном для себя, для изучения языка и инструмента» и так понятно, а зачем это ещё для чего-то может понадобится?

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

а зачем это ещё для чего-то может понадобится?

Для простых людей, которые пользователи, а не админы и разрабы. Для того чтобы человек мог прочитать мануал по cd/pwd/rm/etc нормальным системным способом на понятном языке. Не все поголовно должны знать английский, не у всех работа завязана на него.

mandala ★★ ()

А разве обновление этих страниц не задача авторов и мейнтейнеров соответствующих пакетов и библиотек?

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

http://man7.org/linux/man-pages/man7/man-pages.7.html

man man-pages
        Таким образом, проект обеспечивает большую часть страниц раздела 2,
        Многие страницы, представленные в разделах 3, 4 и 7, и несколько
        Страницы, которые отображаются в разделах 1, 5 и 8 справочных страниц на
        Linux.  Соглашения, описанные на этой странице, также могут быть
        Полезно для авторов, пишущих man-страницы для других проектов.
mandala ★★ ()
Ответ на: комментарий от mandala

чтобы человек мог прочитать мануал по cd/pwd/rm/etc

Нахрена «простому человеку» эта дичь? Double-click/right-click по папке он и без мануалов освоит.

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

Хочешь сказать, что линукс исключительно для профи?

Если у тебя ТАКИЕ проблемы с пониманием текста объёмом в пару предложений, то лично тебе перевод манов точно не поможет. Вот где именно в моём сообщении ты умудрился это вычитать?

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

«Простой человек» не обязательно клинический мышкотыкатель, хотя таких большинство, не спорю.

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

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

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

клинический мышкотыкатель

Поменьше апломба - этот «мышкотыкатель» в своей профессиональной области вполне возможно нас с тобой за пояс заткнёт. Нежелание учить странные аббревиатуры с малопонятными параметрами ещё не делает пользователя хуже нас с тобой.

Ну а если «захотелось странного», то книжки в помощь.

Перевод актуальных man-страниц - пустая трата времени: начинающему и книжки хватит, а профессионалу или тому, кто твёрдо решил стать таковым всё-равно английский учить прийдётся.

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

«Клинический мышкатыкатель» это не апломб — они обычно такие от нежелания, им и новый интерфейс GUI также чужд как и командная строка.

Перевод актуальных man-страниц - пустая трата времени

Но вот кто-то их переводит, на самые разные языки.

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

Тот, кто не способен её прочесть на языке оригинала, в принципе профнепригоден.

А сам хоть понял, что написал?

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

Поменьше апломба - этот «мышкотыкатель» в своей профессиональной области вполне возможно нас с тобой за пояс заткнёт. Нежелание учить странные аббревиатуры с малопонятными параметрами ещё не делает пользователя хуже нас с тобой.

Перевод актуальных man-страниц - пустая трата времени: начинающему и книжки хватит, а профессионалу или тому, кто твёрдо решил стать таковым всё-равно английский учить прийдётся.

А вот мне когда-то очень помогали маны на русском.

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

Но, суровая правда в том, что сами маны почти никому не нужны.

Маны нужны всем, кто ведёт разработку под *nix.

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

stackoverflow имхо полезнее.

За справкой по опциям ssh тоже на SO лезть?

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

А в той теме большинство прямым текстом писали, что никакие маны они никогда не читают, что они написаны, якобы, марсианским языком

Но, суровая правда в том, что сами маны почти никому не нужны.

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

Людям проще открыть браузер и получить более подробную и понятную информацию через какой-нибудь блог, где это все подробно расписано или купить книгу.

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

Людям проще открыть браузер

Отлично, тогда чтобы получить мгновенную справку по параметрам функции мне нужно не тут же в консоли написать man 3 strtol, а иметь иксы, запускать браузер, который сейчас требует 1ГБ+ памяти и там смотреть те же самые двадцать строчек. Особенно весело это делать через ssh. Спасибо, анон, действительно удобно.

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

мне нужно не тут же в консоли написать man 3 strtol, а иметь иксы, запускать браузер

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

Я говорил что концепция манов нуждается в переосмыслении и переработке, ибо для не гиков они сложны для чтения и понимания. Маны должны быть: 1) доступны не только из терминала на локальной машине; 2) иметь подробные и понятные примеры использования софта; 3) быть гламурными, стильными, модными и молодежными.

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

быть гламурными, стильными, модными и молодежными.

Ненужные перделки.

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

И зачем поддерживать две версии? Двойная работа. Если так хочется - напишите утилиту которая будет автоматом перегонять man-файлы в html и цеплять туда css.

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

Ненужные перделки.

Удобно, логично и понятно не значит перделки.

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

профнепригоден

Линаксоид таки профессия?

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