Самодокументированность исходного кода это конечно хорошо, но нужно хотя бы какое-то overview функций, краткий справочник.
Какого рода документация нужна ? man-страницы (как для glibc) ? Как я понимаю, будет не достаточно вынести описания функций.
В долгосрочной перспективе - man-ы на английском. Дополнительно можно сделать статью на wiki на русском.
При наличии нормальных манов, на wiki нужны только проектные страницы на двух языках, с описанием, что такое libshell и где его репозиторий, для майнтайнеров других дистрибутивов - без этого те же sisyphus-mirror, mkimage или gear опакетить нормально нельзя. Такое я сделать могу в любой момент.
(In reply to comment #2) > В долгосрочной перспективе - man-ы на английском. Постараюсь сделать. Давно про это думал, но как-то из-за нескольких функций руки не доходили. Но раз вы просите, значит настал момент собраться и сделать. > Дополнительно можно сделать статью на wiki на русском. Увольте-с.
На вики: http://www.altlinux.org/libshell http://en.altlinux.org/libshell Больше ничего особенно и не нужно.
(In reply to comment #5) > Больше ничего особенно и не нужно. Говорите за себя. Это не документация. Такую "документацию" я мог бы написать, чтобы ничего не делать.
> > Больше ничего особенно и не нужно. > Говорите за себя. На wiki больше ничего не нужно. > Это не документация. Это проектные страницы.
libshell-0.4.2-alt1 -> sisyphus: * Fri Nov 18 2016 Alexey Gladkov <legion@altlinux> 0.4.2-alt1 - New version (0.4.2). - Add more docs (ALT#17927). - New utilities: + shell-terminfo to simplify work with terminfo. + cgrep utility. - shell-getopt changes: + Fix encoding in comment.
