eurekafag
19.02.2011 09:06 WOK
ВРЕМЯ НАУЧИТЬСЯ ПИСАТЬ МАНЫ! http://www.schweikhardt.net/man_page_how... ПИШИ МАН, БУДЬ МУЖИКОМ БЛЕАТЬ! ОСТАВЬ В README.TXT ТОЛЬКО ПАРУ ПРЕДЛОЖЕНИЙ ОПИСАНИЯ И КОМАНДУ man myfuckingmegaprogram.1 !
Recommended by:
@Kona-chan,
@Minoru
6 comments
recommend
bookmark
subscribe
Схоронил.
А если серьёзно, то программа с маном сразу выглядит на голову выше и достойнее, чем скрипт с ридмишкой (как это обычно делаю я ._.). Так что пора взрослеть и делать всё по уму.
Но скрипт на 20 строчек с маном будет выглядеть смешно, потому что объем мана будет больше объема скрипта. Для манов нужно что-то глобальное писать.
Ничего смешного. Наличие мана не может быть лишним, если у тебя в скрипте хотя бы 3-5 параметров, уже стоит писать ман. С примерами.
Для трех-пяти параметров достаточно и хелпа. Его все равно делать, а смысла дублировать хелп в ман я не вижу. Вариант с маном rage-хелпом типа progname [-abcdefghjklmnopqrst] file я вообще не хочу поднимать.
Вопрос личной философии, конечно. Но я бы не стал пихать примеры в хелп, не для того он делается. Без примеров же зачастую разбираться сложнее, так что они не помешают.