ozmake - 云端在线

程序：

您的姓名

Ozmake - 为 Oz 制作

概要

奥兹马克 - 帮帮我
奥兹马克 [ - 建造] [目标...]
奥兹马克 - 安装 [目标...]
奥兹马克 - 安装 [--包=PKG]
奥兹马克 - 卸载 [--包=PKG]
奥兹马克 - 干净的
奥兹马克 - 很干净
奥兹马克 - 创建 [--package=文件]
奥兹马克 - 发布
奥兹马克 - 提炼 [--包=PKG]
奥兹马克 - 列表 [--package=MOGUL]
奥兹马克 --config=(放置|删除|列表) ...
奥兹马克 --mogul=(放置|删除|列表|导出) ...

商品描述
奥兹马克 配置 目标

奥兹马克 是用于构建基于 Mozart 的项目以及用于创建和安装 Mozart 的工具
包。 它的灵感来自 Unix 工具 使 和 转，但要简单得多，是
专门用于基于莫扎特的软件开发和部署，并透明地
支持移植了莫扎特的所有平台。 奥兹马克 当前必须被调用
来自 shell，但它最终会额外获得一个可选的、用户友好的
图形界面。

配置

下面，我们在尖括号之间写元变量，例如 or <URI as
缓存 路径>

一般用途总体评估 附加选项
-v --详细
打印出比默认值更多的跟踪信息。 通过提供此选项
两次，您有时会获得更多信息。

-q --安静
抑制所有跟踪和反馈信息

-n --just-打印
执行试运行，即只打印会发生什么而不实际执行
行动

- 当地的
不要递归到子目录

--（无）自动依赖
默认情况下： true
自动确定构建时和安装时（运行时）依赖项。
目前，仅通过查看 import 和 require 支持 Oz 源
部分。

--(否)需要
默认情况下： true
自动获取并安装当前所需的其他软件包。 这个
选项与构建和安装都相关。

在这里你应该记住的是 -vn 是你的朋友。 添加 -vn 在任何结束时
奥兹马克 调用，它将非常详细地告诉您该命令将执行的操作，而无需
实际上在做。

目录 和 网址
--前缀=
默认情况下： 〜/.oz
私有安装区根

--目录=
默认情况下： 当前目录
下面其他选项的默认目录

--builddir=
默认情况下：
要构建的目录

--srcdir=
默认情况下：
源文件所在的目录

--bindir=
默认情况下： /箱
放置 bin 目标的目录

--libroot=
默认情况下： /缓存
安装 lib 目标的缓存的根目录

--libdir=
默认情况下： /<URI as 缓存 路径>
安装 lib 目标的目录

--docroot=
默认情况下： / DOC
安装 doc 目标的根目录

--docdir=
默认情况下： /<大亨 as 文件名>
安装 doc 目标的目录

--提取目录=
默认情况下：
将包解压缩到的目录

--存档=
默认情况下： http://www.mozart-oz.org/mogul/pkg
可以从中下载软件包的 mogul 存档的 URL

--moguldir=
用于放置用户贡献的子目录的目录：
包目录，一个用于文档，一个用于 mogul 数据库条目。

--大亨网址=
MOGULDIR目录对应的url

档
-m --生成文件=
默认情况下： /makefile.oz
生成文件的位置

-p --包=
包的文件或 URL。 创建包时，它应该是本地文件名。
解压或安装时，也可以是URL或mogul id； 在后者
情况下，包会自动从 mogul 存档中下载

-V --包版本=
此选项受到尊重 - 提炼 和 - 安装 。什么时候 - 提炼 给出
一个 MOGUL id 并从 MOGUL 存档下载相应的包，它将
精确查找包的给定版本。 - 安装 将简单地检查
要安装的包确实有这个版本。

--数据库=
默认情况下： /数据库
已安装包数据库的基本路径。 数据库保存在pickled和
分别在文件 DB.ozf 和 DB.txt 中的文本格式

政策和帮助
奥兹马克 - 帮帮我

-h --帮助
打印此信息消息

构建
奥兹马克 [ - 建造]
构建所有目标

奥兹马克 [ - 建造] 文件...
建立这些目标

-b --构建
这是默认设置。 构建包的目标

--optlevel=( 无 | 调试 | 优化 )
默认情况下： 优化
选择编译的优化级别

-g --debug --optlevel=调试
编译调试

-O -​​-optimize --optlevel=optimize
编译完全优化。 这是默认设置

--(不)gnu
是 C++ 编译器 GNU 编译器。 这是自动确定的，并允许
更高的优化级别，即通过 -氧气 而不只是 -O 以及
编译

--（否）完整构建
默认情况下： false
还构建 src 目标

--includedir 目录 -I 目录
告诉 C++ 编译器额外在 DIR 中搜索包含文件

--（无）sysincludedirs
默认情况下： true
告诉 C++ 编译器额外搜索（或不搜索，如果使用 --nosysincludedirs
) 位于全局安装中的 Mozart 特定的包含目录
目录和用户的私人 〜/.oz 区。

--librarydir 目录 -L 目录
告诉 C++ 链接器额外搜索库的 DIR

--（否）syslibrarydirs
默认情况下： true
告诉 C++ 链接器额外搜索（或不搜索，如果使用 --nosyslibrarydirs
) 位于全局安装中的 Mozart 特定库目录
目录和用户的私人 〜/.oz 区。

安装
奥兹马克 - 安装
使用 makefile 安装

奥兹马克 - 安装 文件...
使用 makefile 安装这些目标

奥兹马克 - 安装 --包=PKG
安装包 PKG

-i --安装
安装包的目标并更新包数据库

--grade=( 无 | 相同 | 向上 | 向下 | 任何 | 清新 )
默认情况下： 没有
如果已经安装了这个包怎么办？ ozmake 将比较版本和
日期，其中版本更重要。 --等级=无 发出错误信号
--等级=相同 要求版本和日期相同 --等级=向上 需要一个
具有更新版本或相同版本和更新发布日期的包
安装 --等级=下 需要旧版本或相同版本的包，并且
比安装的发布日期早 --等级=任何 没有条件 --等级=新鲜
如果软件包较新，则安装，否则什么都不做

-U --升级
相当于 - 安装 --等级=向上

--降级
相当于 - 安装 --等级=下

-A——任意等级
相当于 - 安装 --等级=任何

-F --新鲜
相当于 - 安装 --等级=新鲜

--(no) 替换文件
默认情况下： false
允许安装覆盖其他包中的文件

-R --替换
相当于 - 安装 --等级=任何 --替换文件

--(no) 扩展包
默认情况下： false
是否替换或扩展此软件包的当前安装（如果有）

-X --扩展
相当于 - 安装 --等级=任何 --扩展包

--（否）已保存数据库
默认情况下： true
安装后保存更新的数据库

--包含文档 --排除文档
默认情况下： --包含文档
是否安装文档目标

--includelibs --excludelibs
默认情况下： --includelibs
是否安装 lib 目标

--includebins --excludebins
默认情况下： --includebins
是否安装 bin 目标

--（不）保持僵尸
默认情况下： false
是否删除此包以前安装时遗留的文件

--exe=( 默认 | 是 | 否 | 两者 | 多 )
默认情况下： 默认
Windows 上的约定是可执行文件有一个 .exe，而在 Unix 上它们有
没有扩展名。 这 - 可执行程序 选项允许您控制所使用的约定
ozmake 安装可执行文件时。 --exe=默认 使用平台的约定
--exe=是 使用 .exe 扩展名 --exe=否 不使用扩展名 --exe=两者 安装所有
带有 .exe 扩展名和不带 .exe 扩展名的可执行文件 --exe=多 安装可执行函子
适用于 Unix 和 Windows。 Unix 版本安装时不带扩展名，并且
Windows 版本安装有 .exe 扩展名

卸载
奥兹马克 - 卸载
卸载makefile描述的包

奥兹马克 - 卸载 --包=PKG
卸载由 mogul id 命名的包 PKG

-e --卸载
卸载一个包

清洁
奥兹马克 - 干净的
奥兹马克 - 很干净
删除由 makefile 的 clean 和 veryclean 特性指定的文件。
- 很干净 暗示 - 干净的 .

创建
奥兹马克 - 创建 [--包=]
创建一个包并将其保存在 FILE.the 包所需的文件是
从生成文件自动计算。 如果 --包= 不提供，一个
默认值是使用在
生成文件。

--include(bins|libs|docs) --exclude(bins|libs|docs)
控制包中包含哪些目标类型

发布
奥兹马克 - 发布
自动处理创建/更新包所需的所有步骤
由用户提供，并将所有必要的数据提供给 MOGUL
图书管理员。 请参阅文档 --大佬 联络一位教师

提取
奥兹马克 - 提炼 --包=
从文件或 URL PKG 中提取文件。如果 PKG 是一个 mogul id，那么包是
自动从 mogul 存档下载

列表
奥兹马克 - 列表
列出已安装包数据库中所有包的信息

奥兹马克 - 列表 --包=
列出由 mogul id MOGUL 标识的已安装包的信息

--线宽=N
默认情况下： 70
假设一条线 N 字符

配置
奥兹马克 --config=放置
在 ozmake 的配置数据库中记录给定的 OPTIONS，并将它们用作
ozmake 的后续调用中的默认值，除非在
命令行。 例如： 奥兹马克 --config=放置 --前缀=/usr/local/oz 节省
/usr/local/oz 作为选项的默认值 - 字首

奥兹马克 --config=删除 ...
从配置数据库中删除一些条目。 例如： 奥兹马克
--config=删除 字首 删除默认值 - 字首 从配置
数据库

奥兹马克 --config=列表
列出ozmake的配置数据库的内容

论据 --配置 可以缩写为任何非歧义前缀

莫卧儿
如果您选择向 MOGUL 档案库贡献软件包， 奥兹马克 --大亨=
简化您的任务。 它使您可以轻松维护您的数据库
贡献并导出它们，以便 MOGUL 图书馆员可以自动找到它们。
其实最简单的方法就是使用 奥兹马克 - 发布 这将照顾所有
为您提供详细信息。

奥兹马克 --mogul=放置
使用此数据更新用户自己的大人物贡献数据库
贡献（在本地目录中）

奥兹马克 --mogul=放置 --包=
同上，但使用明确给出的包 PKG

奥兹马克 --mogul=删除 ...
从用户自己的数据库中删除具有 mogul ids MOG1 到 MOGn 的条目
贡献

奥兹马克 --mogul=删除
删除当前贡献的条目

奥兹马克 --mogul=列表
显示用户自己的大亨的数据库中所有条目的记录数据
捐款

奥兹马克 --mogul=列表 ...
在用户自己的数据库中显示条目 MOG1 到 MOGn 的记录数据
大人物的贡献

奥兹马克 --mogul=出口
为用户自己的大人物贡献编写所有必要的大人物条目。 这些是
MOGUL 图书馆员将读取的条目以自动组装
完整的 MOGUL 数据库。

您的贡献数据需要提供给 MOGUL 图书馆员
网络。 您只想用您的贡献更新本地目录，但是，为了
MOGUL 图书馆员找到它们，这些目录也必须通过 URL 上的
网络。 以下是一些允许您控制此通信的选项，对于
您应该使用它设置默认值 奥兹马克 --config=放置

--moguldir=

--大亨网址=
MOGULDIR 是一个目录，也可以通过 url MOGULURL 在 WEB 上获得。
MOGULDIR 旨在作为根目录，其中包含包的子目录，
文档和大人物条目将被找到。

对于那些真正享受痛苦的人， 奥兹马克 当然有很多选择来拍摄自己
脚。 在下面的选项中 代表包的大佬的文件名版本
id（基本上用破折号替换斜线）。 您可以控制包的位置，它们的
文档和 mogul 数据库条目并使用选项存储和提供
下面：

--mogulpkgdir=
默认情况下： /包//

--mogulpkgurl=
默认情况下： /包//

--moguldocdir=
默认情况下： /文档//

--moguldocur=
默认情况下： /文档//

--moguldbdir=
默认情况下： /D b//

--moguldbur=
默认情况下： /D b//

你的贡献都应该有大佬 ids 如下。 你所在的大亨 ID
授予您的 mogul 数据库部分。 为了方便， 奥兹马克 将尝试
一旦您的数据库中有条目，就猜测您的部分的根大亨 ID
你自己的贡献。 然而，最好告诉 奥兹马克 关于它使用：

--大亨rootid=

并使用 奥兹马克 --config=放置 --大亨rootid=

制作文件

生成文件包含一个描述项目的 Oz 记录，通常应该
被放置在一个名为 生成文件.oz.A makefile 通常如下所示：

生成文件（
lib : ['Foo.ozf']
uri : 'x-ozlib://mylib'
大亨：'大亨：/denys/lib-foo')

明确声明有一个库目标，即函子 文件，然后
它应该安装在 URI：

x-ozlib://mylib/Foo.ozf

并隐含地表示它应该从 Oz 源文件中编译 Foo.oz.当你调用
奥兹马克 - 安装， 大亨 功能用于唯一标识此包和文件
它有助于 奥兹马克 已安装软件包的数据库。

在 makefile 中可以出现更多的特性，它们都是可选的。 如果
你省略了所有的功能，你只得到默认值，你甚至不需要生成文件。
所有值，例如 档, 应作为虚拟字符串给出； 建议使用原子，除了
对于特征 脱口秀, 信息文本 和 信息_html, 推荐使用字符串。

生成文件（
垃圾箱：[文件...]
库：[文件...]
文档：[文件...]
源代码：[文件...]
要看 ：
o( 文件 : [ 文件... ]
...
)
规则：
o（文件：工具（文件）
...
)
干净：[全局...]
非常干净：[全局...]
乌里：乌里
大亨：大亨
作者：[作者...]
发布日期：日期
简介：文本
info_text : 文本
info_html : 文本
子目录：[目录...]
要求：[大佬...]
类别：[ 类别... ]
版本：版本
提供：[文件...]
)

要安装的功能 bin、lib 和 doc 列表目标 , 和
。 箱子 目标应该是可执行的函子，即它们应该以
延期 。可执行程序. LIB 目标通常是编译的函子，即以扩展名结尾
.ozf,但也可以是本机函子，即以扩展名结尾 。所以，或简单的数据
文件。 DOC 目标是文档文件。

扩展
奥兹马克 通过查看目标的扩展名知道如何构建目标：

文件

是一个可执行的函子，是从 文件

文件

是一个编译的函子，是从 Foo.oz

富欧

是一个编译后的 C++ 文件，是从 文件

富索

是一个本机函子，是从 富欧

文件

是一个 C++ 源文件

呵呵

是一个C++头文件

请注意，这些是 抽象 目标。 特别是， 富索 真正表示文件
Foo.so- 哪里 标识架构和操作系统，其中
包已构建； 例如： linux-i486.另外，当一个 bin 目标 文件 is
安装，它被安装为 /Foo.exe 和 /Foo 这样它就可以
调用为 富 在 Windows 和 Unix 平台上。

您必须遵守此处描述的扩展的常规使用：
奥兹马克 不允许变化并且不支持其他扩展。

规则
奥兹马克 具有用于构建文件的内置规则。 有时，您可能想要覆盖
一个或多个目标的默认规则。 这是通过功能完成的 排除 其中包含一个
记录映射目标到规则：

目标文件：工具（源文件）

该规则也可能有一个选项列表：

TARGET_FILE ：工具（SOURCE_FILE 选项）

支持的工具 奥兹马克 旨在 盎司 （盎司编译器）， 盎司 （盎司链接器）， cc （C++ 编译器），
ld （C++ 链接器）。 默认规则是：

'Foo.exe' : ozl('Foo.ozf' [可执行文件])
'Foo.ozf' : ozc('Foo.oz')
'Foo.o' : cc('Foo.cc')
'Foo.so' : ld('Foo.o')

这些工具支持以下选项：

盎司

可执行

使结果可执行

'定义'(S)

定义宏 S. 与 -D 相同S 在命令行上

盎司

可执行

使结果可执行

cc

包括（目录）

类似于通常的 C++ 编译器选项 -IDIR. DIR 是一个虚拟字符串

'定义'（MAC）

类似于通常的 C++ 编译器选项 -DMAC. 苹果电脑 是一个虚拟字符串

ld

图书馆（目录）

类似于通常的 C++ 链接器选项 -lDIR. DIR 是一个虚拟字符串

您可能需要指定规则来创建预链接库：

'Utils.ozf' : ozl('Foo.ozf')

或者创建一个非预链接的可执行文件：

'Foo.exe' : ozc('Foo.oz' [可执行文件])

依赖
奥兹马克 自动确定是否需要重建目标，例如因为它们
丢失或创建它们所需的某些源文件已被修改。 规则是
用于确定文件之间的依赖关系。 有时这是不够的，例如因为
你使用工具 盎司 （依赖进口），或 插 在 Oz 文件中，或在 C++ 中 #include
文件。 在这种情况下，您可以使用功能指定其他依赖项 依靠 这是
将目标映射到依赖项列表的记录：

目标：[文件...]

例如：

'Foo.o' : [ 'Foo.hh' 'Baz.hh' ]

or

'Foo.exe' : [ 'Lib1.ozf' 'Lib2.ozf' ]

清洁
在开发过程中，能够轻松删除所有垃圾和
编译的文件再次获得一个干净的项目目录。 这得到了支持 奥兹马克
- 干净的 和 奥兹马克 - 很干净;后者也暗示前者。 要删除的文件是
由 水珠 模式在哪里 ? 匹配任何 1 个字符并且 * 匹配0的序列
或更多字符。 BUILDDIR 中匹配一种此类模式的所有文件都将被删除。 有
内置模式，但您可以使用功能覆盖它们 清洁 和 很干净 这
应该是 glob 模式列表。 例如，默认的干净 glob 模式是：

干净：[“*~”“*.ozf”“*.o”“*.so-*”“*.exe”]

小包装 相关 产品优势
URI

特集 URI 指示安装 lib 目标的 URI。 例如：

uri : 'x-ozlib://mylib/XML'

指出所有 LIB 目标（例如 文件) 将安装在此 URI 下，以便它们
也可以从中导入，即：

在“x-ozlib://mylib/XML/Foo.ozf”处导入 MyFoo

大亨

特集 大亨 是唯一标识此包的大亨 ID。 它用于识别
已安装包数据库中的包，以创建/发布包，以及
安装其文档文件。

作者

特集 作者 是一个虚拟字符串或虚拟字符串列表。 确定作者
或包的作者。 建议通过他们的大亨 ID 来识别作者，
但是也可以简单地给出他们的名字。 例如，推荐的方式
是：

作者：'大亨：/公爵'

但以下也是可能的：

作者：'丹尼斯·杜奇尔'

发布

特集 发布 是一个虚拟字符串，指定在
以下格式：

发布：“YYYY-MM-DD-HH:MM:SS”

时间是可选的。 使用当前日期和时间的适当发布日期是
调用时自动插入 奥兹马克 - 创建 or 奥兹马克 - 发布..

脱口秀

特集 脱口秀 包含一段非常短的描述包的文本。 这段文字应该
仅一行，用于在包发布时用作标题
大亨档案。

信息文本

特集 信息文本 包含包的纯文本描述。 这旨在成为
用作 mogul 档案中包的演示页面上的摘要。 它
应该简短且信息丰富，但不应试图记录包裹。

信息_html

特集 信息_html 类似于 信息文本 但包含 HTML 而不是纯文本。

SRC

特集 SRC 指示应将哪些目标视为源，即特别是非
可建造。 中提到的所有目标 SRC 应该在 箱子, LIB，要么 DOC 也。 这
点 SRC 是支持分发带有预构建目标的包并且不提供
出相应的来源。 你不应该用原生函子来做这件事，因为它们是
平台相关且不可移植，但它可以是一种方便的分发预
建立了 Oz 图书馆。 例如：

生成文件（
库：['Foo.ozf']
源代码：['Foo.ozf']
uri : 'x-ozlib://mylib'
大亨：'大亨：/我的名字/foolib')

是分发预编译包的makefile 文件,但不也
分发其来源 Foo.oz.通常，当你构建一个包时，它只是检查
SRC 文件存在但不会尝试构建它们。 如果你有资源，你可以
强制建立 SRC 必要时使用目标 --完整构建..

子目录

特集 子目录 是代表项目子目录的裸文件名列表。 经过
默认，必要时， 奥兹马克 将递归到这些子目录中。 预计
每个子目录都应该提供自己的makefile。 大亨 id 是自动的
继承到子目录，通过附加名称自动扩展 uri
子目录：因此子生成文件可以更简单，因为它们不需要关心
具有包级功能。

需要

特集 需要 是模块 URI 或包 MOGUL id 的列表。 这些代表
外部 包的依赖。 它们尚未使用，但最终 奥兹马克 会
能够使用它们来自动递归安装所需的其他软件包
你感兴趣的一个。

类别

特集 类别 是 MOGUL 类别的列表，以帮助在
MOGUL 存档。

版本

特集 版本 用于提供版本字符串。 这是一个包含以下内容的字符串
由单点分隔的整数，例如 “2” or “3.1.7”..

提供

特集 提供 用于覆盖有关包的默认信息
提供，通常自动从 箱子 和 LIB 目标：它应该是一个
包含这些目标的子集的列表。 这 提供 makefile 的特性没有
覆盖或以其他方式影响其子生成文件：每个生成文件应单独覆盖
如果它愿意的话。 声明 makefile 没有正式提供任何函子或
可执行应用程序，您将添加：

提供：无

您应该使用 提供 当您的包包含官方公共
函子以及不属于官方的纯粹实现函子
公共接口，不应被提及为 提供 由包裹。

联系方式

作者应该真正被大佬 id 引用，这些大佬 ID 表示描述描述的大佬条目
他们。 为了使这更容易，一个 生成文件.oz 也可能包含一个 联系 特点
是描述一个人的记录，或此类记录的列表。

你不应该有 联系 每个 makefile 中的功能。 而是， 联系 功能是
通常用于只有一个 联系 特征，即其唯一目的
是为相应的人创建大人物条目。 这是一个这样的例子
生成文件：

生成文件（
联系方式：
o(
大亨：'大亨：/duchier/denys'
名称：'丹尼斯·杜奇尔'
电子邮件 ： '[电子邮件保护]'
万维网：'http://www.ps.uni-sb.de/~duchier/'))

你可以调用 奥兹马克 - 发布 在这样的 makefile 上贡献相应的大人物
数据库条目

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