noweb - Інтернет у хмарі

ПРОГРАМА:

ІМ'Я

noweb - простий інструмент для грамотного програмування

СИНТАКСИС

noweb [-t] [-o] [-Lформат] [-розмітка аналізатор] [файл] ...

ОПИС

Noweb є грамотним інструментом програмування, як FunnelWEB or nuweb, тільки простіше. А noweb файл
містить вихідний код програми, переплетений з документацією. Коли noweb викликається, це
записує вихідний код програми у вихідні файли, згадані у файлі noweb, і він
пише а TeX файл для набірної документації.

The noweb(1) команда призначена для людей, які не люблять читати сторінки керівництва або перемикаються
від nuweb. Щоб отримати максимальну віддачу noweb, Використовуйте некутник(1) і зараз(1) замість цього.

ФОРМАТ OF ЗАРАЗ ФАЙЛИ

A noweb файл є послідовністю шматки, які можуть відображатися в будь-якому порядку. Шматок може містити
код або документація. Фрагменти документації починаються з рядка, який починається зі знака at
(@), а потім пробіл або новий рядок. У них немає імен. Фрагменти коду починаються з
<<шматок ім'я>> =
на рядку окремо. Подвійна ліва кутова дужка (<<) має бути в першому стовпці.
Частки завершуються початком іншого фрагмента або кінцем файлу. Якщо перший
рядок у файлі не позначає початок фрагмента, він вважається першим
рядок фрагмента документації.

Фрагменти документації містять текст, який дослівно скопійовано до TeX файл (крім
цитований код). noweb працює з LaTeX; перший фрагмент документації повинен містити a LaTeX
\documentclass команду, вона повинна містити \usepackage{noweb} у преамбулі, і, нарешті, він
також має містити a LaTeX \ Begin {документ} команда

Фрагменти коду містять вихідний код програми та посилання на інші фрагменти коду. Кілька кодів
шматки можуть мати однакову назву; noweb об’єднує їхні визначення для створення єдиного
chunk, як і інші грамотні інструменти програмування. noweb шукає шматки, які є
визначено, але не використовується у вихідному файлі. Якщо назва такого блоку не містить пробілів,
фрагмент є ``вихідним файлом;'' noweb розгортає його та записує результат у файл
таку саму назву. Визначення фрагмента коду схоже на визначення макросу; він містить посилання
на інші фрагменти, які самі розширюються, тощо. nowebВихід ' читається; це
зберігає відступ розгорнутих фрагментів відносно фрагментів, у яких вони
з'являються.

Якщо зірка (*) додається до імені вихідного файлу, noweb включає номер рядка
інформацію, як зазначено в -Lформат варіант (або для C, якщо ні -Lформат надається варіант).
Сама назва не може містити метасимволів оболонки.

Код можна цитувати в фрагментах документації шляхом розміщення подвійних квадратних дужок ([[...]])
навколо нього. Ці подвійні квадратні дужки використовуються для надання коду особливої ​​типографії
лікування в TeX файл. Якщо код у лапках закінчується трьома або більше квадратними дужками, noweb
вибирає найправішу пару, щоб, наприклад, [[a[i]]] розбирається правильно.

У коді noweb розглядає непарні подвійні ліві або праві кутові дужки як буквальні << та >>.
Щоб примусово, щоб будь-які такі дужки, навіть парні дужки або дужки в документації, були
розглядається як буквальний, використовуйте попередній знак at (наприклад @<).

ВАРІАНТИ

-t Придушити генерацію a TeX файлу.

-o Придушити створення вихідних файлів.

-Lформат
Скористайтесь формат для форматування інформації про номер рядка для вихідних файлів із зірочкою. (Якщо
Параметр опущено, використовується формат, придатний для C.) формат як визначено
некутник(1);

-розмітка аналізатор
Скористайтесь аналізатор щоб проаналізувати вхідний файл. Дозволяє використовувати інструменти noweb для файлів в інших
формати; наприклад, numarkup парсер розуміє nuweb(1) формат. Побачити
nowebfilters(7) для отримання додаткової інформації. Тільки для експертів.

Використовуйте noweb онлайн за допомогою служб onworks.net