Почему не окружают builtins, имеют надлежащие страницы справочника?

man bash 2>/dev/null | 
grep '^[[:blank:]]*read [^`]*[-[]' -A14

   read [-ers] [-a aname] [-d  delim]  [-i  text]  [-n
   nchars]  [-N  nchars]  [-p prompt] [-t timeout] [-u
   fd] [name ...]
          One line is read from the standard input, or
          from  the  file descriptor fd supplied as an
          argument to the -u  option,  and  the  first
          word is assigned to the first name, the sec‐
          ond word to the second name, and so on, with
          leftover words and their intervening separa‐
          tors assigned to the last  name.   If  there
          are  fewer  words read from the input stream
          than names, the remaining names are assigned
          empty  values.   The  characters  in IFS are
          used to split the line into words using  the
          same  rules  the  shell  uses  for expansion

... который довольно близко к тому, что я использовал, когда Поиск Shell Page Man . Но помощь довольно хорошо в Bash в большинстве случаев.

Я на самом деле работал над скриптом SED , чтобы справиться с такими вещами. Это то, как я схватил раздел на картинке выше. Это все еще дольше, чем мне нравится, но это улучшается - и может быть довольно удобным. В своей нынешней итерации он довольно надежно извлеките контекстно-чувствительную секцию текста, что соответствует разделу или заголовку подразделения на основе [a] pattern [s], учитывая его на командной строке. Он окрашивает свой вывод и отпечатки на STDOUT.

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

Это означает, что матч образец будет соответствовать:

heading
    match ...
    ...
    ...
        text...

.. и ..

match
   text

.. но нет ..

heading
    match
    match

    notmatch

.. или ..

         text

         match
         match
         text

         more text

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

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

Мне немного понять, как выяснить, как рекурсировать на подзаголовки, как следующее:

Section Heading
    Subsection Heading

Но я сортировал его в конце концов.

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

Весь процесс очень быстрый, потому что большую часть времени это всего лишь /./ d Электрикает любую не пустую линию и перемещается к следующему - даже результаты ZShall экран мгновенно. Это не изменилось.

В любом случае, это очень полезно до сих пор. Например, чтение вещь выше можно сделать:

mansed bash read

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

mansed bash read printf

... Оба блока возвращаются целыми. Я часто использую это как:

mansed ksh '[Cc]ommand.*'

... для которого это довольно полезно. Также, получение Synops [es] делает его действительно удобным:

здесь, если вы хотите, чтобы убрать его - я не виню тебя, если вы не все.

mansed() {
MAN_KEEP_FORMATTING=1 man "$1" 2>/dev/null | ( shift
b='[:blank:]' s='[:space:]' bs=$(printf \\b) esc=$(printf '\033\[') n='\
' match=$(printf "\([${b}]*%s[${b}].*\)*" "$@")
sed -n "1p
    /\n/!{  /./{    \$p;d
        };x;    /.*\n/!g;s///;x
    :indent
        /.*\n\n/{s///;x
        };n;\$p;
        /^\([^${s}].*\)*$/{s/./ &/;h;   b indent
        };x;    s/.*\n[^-[]*\n.*//; /./!x;t
        s/[${s}]*$//;   s/\n[${b}]\{2,\}/${n} /;G;h
    };
    #test
    /^\([${b}]*\)\([^${b}].*\n\)\1\([${b}]\)/!b indent
        s//\1\2.\3/
    :print
    /^[${s}]*\n\./{ s///;s/\n\./${n}/
        /${bs}/{s/\n/ & /g;
            s/\(\(.\)${bs}\2\)\{1,\}/${esc}38;5;35m&${esc}0m/g
            s/\(_${bs}[^_]\)\{1,\}/${esc}38;5;75m&${esc}0m/g
            s/.${bs}//g;s/ \n /${n}/g
            s/\(\(${esc}\)0m\2[^m]*m[_ ]\{,2\}\)\{2\}/_/g
        };p;g;N;/\n$/!D
        s//./;  t print
    };
    #match
        s/\n.*/ /;  s/.${bs}//g
        s/^\(${match}\).*/${n}\1/
        /../{   s/^\([${s}]*\)\(.*\)/\1${n}/
        x;  s//${n}\1${n}. \2/; P
    };D
");}

Кратко, рабочий процесс: