noweave - 云端在线

程序：

您的姓名

notangle、noweave、nountangle - noweb，一种文学编程工具

概要

无角 [-R根名...] [-过滤 命令] [-L[格式]] [文件] ...
名词缠结 [-毫升|-立方米|-c|-C++|-awk|-tex|-f77|-f90|-口齿不清|-matlab[-R根名...] [-过滤
命令] [-w宽度] [文件] ...
新纹 [选项] [文件] ...

商品描述

无网 是一种类似于 Knuth 的文学编程工具 网络， 只会更简单。 一种 无网 文件
包含与文档交错的程序源代码。 什么时候 无角 被赋予
无网 文件，它将程序写入标准输出。 什么时候 新纹 被赋予 无网 文件，
它读取 无网 源和产生，在标准输出上， 胶乳, TeX的, 的troff或 HTML
排版文档的来源。 名词缠结 将识字程序转换为普通程序
通过将交错文档转换为注释来编程。 文件名‘-’指的是
标准输入。

FORMAT OF 无网络 FILES

A 无网 文件是一个序列 块, 可能以任何顺序出现。 一个块可能包含
代码或文档。 文档块以 at 符号开头的行开始
(@) 后跟一个空格或换行符。 他们没有名字。 代码块以
<<块 姓名>> =
在一条线上。 双左尖括号 (<<) 必须在第一列中。
块由另一个块的开头或文件结尾终止。 如果第一个
文件中的行不标记块的开始，它被假定为第一个
文档块的行。

文档块包含被忽略的文本 无角 并逐字复制到
标准输出 新纹 （引用代码除外）。 新纹 可以工作 胶乳, 平原
TeX的, 的troff or HTML. 用素色 TeX的, 它插入一个对 a 的引用 TeX的 宏包， 网易,
它定义了类似的命令 \章节 和 \部分。

代码块包含程序源代码和对其他代码块的引用。 几个代码
块可能具有相同的名称； 无角 连接它们的定义以产生单个
块，就像 纠缠(1). 代码块定义就像宏定义；
无角 通过扩展一个块来提取程序（默认情况下，块名为 <<*>>).
该块的定义包含对其他块的引用，这些块本身就是
扩展等等。 无角的输出是可读的； 它保留了缩进
相对于它们出现的块展开的块。

可以通过放置双方括号 ([[...]])
周围。 这些双方括号被忽略 鼻涕虫， 但它们可能会被使用
新纹 给予代码特殊的排版处理，例如超文本链接。 如果引用
代码以三个或更多方括号结尾， 新纹 选择最右边的一对，这样，
例如， [[一[i]]] 被正确解析。 代码块的名称可能出现在
带引号的代码，除非带引号的代码本身是代码块名称的一部分。

在代码中，noweb 将不成对的双左或右尖括号视为文字 << 和 >>.
强制任何此类括号，即使是成对的括号或文档中的括号，
视为文字，使用前面的 at 符号（例如 @<).

某些编程或格式化语言可能需要一个 @ 签到第一栏。
Noweb 用户可以通过将一个双倍的 @@ 在第一列； 在这
仅位置，它代表单个 @ 标志。

缠结

无角 和 名词缠结 接受相同的选项集，虽然有些选项有效果
只有一个或另一个。 选项是：

-R姓名 展开 <<姓名>> 代码块。 这 -R 选项可以重复，在这种情况下每个
块被写入输出。 如果不 -R 给出选项，展开名为的块
<<*>>.

-L格式
在块边界发出行号指示。 行号指示
标识跟随它的行的来源。 在 格式, %F 表示
源文件的名称， %L 表示源文件的行号， %N
表示换行，并且 %% 表示百分号。 一个符号和数字可能是
插入百分号和`L'，在这种情况下，行号将
以该金额进行调整。 如果 格式 被省略，默认格式是
被 C 预处理器接受：`＃线 %L "%F"%N'。 当使用 -L格式 选项，
无角 确保所有文本都出现在输入和输出的同一列中。
名词缠结 忽略此选项。

常见的格式字符串包括：
C -L'#line %L "%F"%N'
孙FORTRAN -L'\# %L "%F"%N'
图标 -L'#line %-1L "%F"%N'
Modula一3 -L'<*LINE %L “％F” *>%N'
SML /新泽西州 -L'(*#line %L “％F”*）'

解决相反的问题，即让 noweb 做一些明智的事情
＃线 在其输入中，请参阅 尖线 在示例目录中过滤。

-tk 将未触及的制表符从输入复制到输出，并使用制表符进行缩进，假设
每隔 k 列。 默认情况下，制表符会扩展为每 8 次停止的空格
列。

-过滤 CMD
过滤 无网 来源 CMD 在将其转换为工具形式之后和之前
纠结。 无角 寻找 CMD 首先在用户的 PATH，然后在 /usr/lib/noweb.
此类过滤器可用于向 无角; 例如，请参见
/usr/lib/noweb/emptydefn. 仅供专家使用。

-标记 解析器
使用 VHDL 语言编写 解析器 解析输入文件。 允许在其他文件中使用 noweb 工具
格式； 例如， 数字加价 解析器理解 新网(1) 格式。 看
无网络过滤器(7) 了解更多信息。 仅供专家使用。

-awk | -c | -icn | -图标 | -毫升 | -立方米 | -帕斯卡 | -f77 | -f90 | -tex
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 名词缠结 将文档块转换为注释，使用注释
命名语言的格式。 -c 是默认值。 无角 忽略这些选项。

-wn 在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 名词缠结 将文档块转换为注释，创建注释
宽度线 n. 无角 忽略此选项。

织造

输出来自 新纹 可用于 TeX的 证明 \输入 新华社， in 胶乳 文件
使用 无网 包（见 无网络风格(1)）和 HTML 要浏览的文档
Mosaic（1）。 新纹 对待代码块有点像 胶乳 名单 环境。 如果``@
'' 终止代码块后紧跟文本，该文本紧随
没有分段符的代码块。 如果该行的其余部分为空白， 新纹 看跌期权 TeX的
进入“垂直模式”，然后文本开始一个新的、缩进的段落。

除非有必要避免过满，否则在代码块中间不会发生分页符
虚拟盒子。 代码块之前的文档块出现在同一页面上
作为该代码块，除非这样做会违反先前的规则。

新纹 不插入额外的换行符 TeX的 输出，所以给出的行号 TeX的
错误消息与输入文件中的相同。

新纹 具有指示选择格式化程序并支持不同格式的选项
习语和工具。 此处描述了基本选项； 与索引和交叉相关的选项
索引和交叉引用部分描述了参考信息。

-乳胶 发出 LaTeX，包括包装在 刊文 风格与 无网 包和页面
风格。 （默认）

-tex 发出普通的 TeX，包括包装器 网易 宏。

-html 使用 HTML 包装器发出 HTML。 输出是无趣的 -指数 or -x.
标签 和 ，在自己的行上，产生一个列表
分别是块和标识符索引。 如果这些标签不存在，
列表和索引放在文件的末尾。

-乳胶+html
假设文档块是 LaTeX，但适当地为代码块生成 HTML
标记为这样的转换 乳胶2html(1) 产生合理的输出。 一个 LaTeX 包装器
是隐含的，但可以关闭 -n. 使用 VHDL 语言编写 of Free Introduction 选项 is 已弃用； 使用
-html - -过滤 2小时 代替。

-特罗夫 发射 的troff(1) 标记（没有包装器）。 结果应该用
诺夫(1). 错误报告 -特罗夫 致亚伦罗宾斯 <[电子邮件保护]>.

-n 不要使用任何包装器（标题或预告片）。 此选项在以下情况下很有用 新纹's
输出将成为更大文档的一部分。 也可以看看 -延迟。

-过滤 CMD
过滤 无网 来源 CMD 在将其转换为工具形式之后和之前
转换为 特克斯。 新纹 寻找 CMD 首先在用户的 小路， 然后在
/usr/lib/noweb.conf 此类过滤器可用于向 现在编织; 为
例子，见 /usr/lib/noweb/noxref.krom。 新纹 最多支持四个过滤器； 一
可以通过shell欺骗获得更多，例如， -过滤 "icon.filter | noidx"。 该
-自动定义, -x, -指数及 -索引来自 选项被实现为过滤器。 过滤器
用 shell 执行 评估 命令，所以 CMD 应相应引用。

-标记 解析器
使用 VHDL 语言编写 解析器 解析输入文件。 允许在其他文件中使用 noweb 工具
格式； 例如， 数字加价 解析器理解 新网(1) 格式。 看
无网络过滤器(7) 了解更多信息。 仅供专家使用。

-选项 选择
添加 \无网络选项{选择} 以及 胶乳 标题。 看 无网络风格(1) 对于的值 选择。
通常仅与 -乳胶 选项，但是 -选项 长引用 工作黑魔法
- -html。

-延迟 默认情况下， 新纹 将文件名和其他信息放入输出之前
程序的第一块。 -延迟 将该信息延迟到第一个之后
文档块，使行为有点像 WEB ``limbo.'' 选项是
通常用于使用户能够放置专门的 胶乳 \文档类 命令
和第一个文档块中的其他序言材料（即， before 这些因素包括原料奶的可用性以及达到必要粉末质量水平所需的工艺。
第一个@符号）。 此选项还强制尾随交叉引用信息
在最后一个块之前发出，而不是在文档的末尾； 这
预计最终块将包含 \end{文档}。 - -延迟 选项意味着
-n 选项。

-tk 展开标签，每停止一次 k 列。 （默认是每 8 列展开一次。）

-t 将选项卡复制到输出。

-v 在标准错误上打印管道和 RCS 信息。

索引 AND 交叉引用

当与 胶乳, 的troff或 HTML， 新纹 可以提供索引和交叉引用
块和编程语言标识符的信息。 标识符定义
可以使用反引号 (`) 手动标记； 这 -过滤 定义 选项识别这些
标记。 对于某些语言，可以使用以下命令自动找到定义 -自动定义
选项。 本节介绍索引和交叉引用选项； 很可能是
跳过第一次阅读。

-x 对于 乳胶， 为每个块名称添加一个页码，以标识该块的位置
块的定义，并发出与定义相关的交叉引用信息和
用途。 为了 HTML， 在块的使用和定义之间创建超文本链接。
在规划婴儿食品行业的工艺要求时，安全性和可靠性是工艺设计中最重要的方面。 新纹 -x 用于 乳胶， 控制序列 \nowebchunks 扩展到一个
所有代码块的排序列表。

-指数 为定义的标识符构建交叉引用信息（或超文本链接）。
定义是在输入文件中找到的那些 -自动定义 language 或
-过滤btdefn。 需要 胶乳 or HTML。 -指数 暗示 -X; 包括两者都会
生成奇怪的输出。 新纹 不会产生交叉引用
出现在带引号的代码中的标识符 (@[[...@]]])，但它确实会生成超文本
链接。 什么时候 新纹 -指数 用于 乳胶， 控制序列 \no网页索引
扩展为标识符索引。

-索引来自 指数
喜欢 -指数， 但要索引的标识符取自文件 指数。 看
NOINDEX（1）。

-自动定义 郎
自动发现标识符定义。 块中的代码必须是语言
郎. 允许 郎s 有所不同，但可能包括 TEX or 图标。 无用 -指数，
它必须先于它。

-showautodefs
显示值 郎 可用于 -自动定义.

ERROR 留言内容

If 无角 or 新纹 在文档中遇到一个块名称，它假设这个
表示错误，通常拼写错误``< >=''。 其他错误信息应该是
不言自明。

引用一个从未定义的块是不正确的，但是块是可以的
定义和未使用。

示例

如果您在消化此手册页时遇到困难，那么您并不孤单。 这里有几个例子
让你开始。 我假设你有一个 foo.nw 包含块中的 C 程序的文件 < >
和块中的头文件 < >，并且您的文档使用
胶乳(1). 我将向您展示如何使用最常见的选项构建事物。

要重建您的 C 源代码，请尝试
无角 -L -Rfoo.c foo.nw > foo.c
要重建头文件，请尝试
无角 -Rfoo.h foo.nw | CPIF foo.h
这里有两个妥协。 省略 -L 保持 ＃线 出你的头文件，和
运用 CPIF 防止命令重写 foo.h 除非内容有变。
因此，这是放入 Makefile 规则的好代码。

要构建打印文档，请运行
新纹 -自动定义 c -指数 foo.nw > 文本文件
如果您有自己的序言，包含 \文档类 所有，你还需要
-延迟 选项。

要构建网页，请运行
新纹 -过滤 2小时 -自动定义 c -指数 -html foo.nw | htmltoc > foo.html
玩得开心！

使用 onworks.net 服务在线使用 noweave