不知什么原因，英文字，间距很宽
2008年4月5日星期六
EMC2 安装说明
emc2/docs/INSTALL
正式安装
-----------------
在标准的 Linux 操作系统上，按下面的过程编译安装:
从顶录录进入到源文件目录:
cd src
在源文件目录中，构建安装EMC2:
./configure
make clean
make
sudo make install
然后输入emc来运行它。
测试安装
-------
如果你想在安装前测试它,或者你担心它会覆盖了已安装好的，可用此方法来测试
你将使用 Run-In-Place （RIP）方式安装:
从顶目录进入到源文件夹:
cd src
在源文件夹中，用（RIP）方式编译安装:
./configure --enable-run-in-place
make clean
make
sudo make setuid
然后返回顶文件夹中，输入下行去运行EMC2：
scripts/emc
详细描述
====================
执行脚本
===============
本软件的运行脚本是 emc ，在安装好的系统上输入 ‘emc’ 来运行。
在 Run-In-Place 方式安装的系统上，(例刚从 CVS 仓库中下载测试),
测运行它要输入路径：
emc2/scripts/emc
如果你刚从CVS中下载,则没有‘scripts/emc’文件，只compilation有‘scripts/emc.in’。
配置程序将跟据它来生成‘scripts/emc’，其实它只是修改其中的某些默认值（文件夹、路径等）。
配置脚本
================
配置脚本‘configure’通过测试而设定适当的值来用于编译安装，它把这些值新建在 ‘Makefile.inc’ 文件中。
然后，它创建‘config.status’脚本,用于以后重建当前的配置文件，
‘config.cache’缓存了测试结果，可更快地重建配置，
‘config.log’记录测试日志（主要用于调试‘configure’）
‘configure.ini’文件用于‘autoconf’程序来创建‘configure’脚本，如果你要用‘autoconf’程序，改变或重建一个新的版本，只需要‘configure.in’文件。
下面简单介绍编译本软件的方法:
1. `cd' 进行到源文件夹中，输入 `./configure' 将根据你的环境进行配置， 如果你用的是
‘csh’ 解析器，你需要输入 `sh ./configure' 即用‘sh’替代‘csh’。
‘configure' 需要花一些时间，运行时，它会输出所检查内容的信息。
2. 输入‘make’开始编译软件。
3. 输入 ‘scripts/emc’测试本软件 。
编译及选项
=====================
有些平台的编译器和链接器需要一些罕见的参数，而‘configure’并不知道需要这些参数，
所以你要在环境变量中设定好这初始参数。 例如用 Bourne-compatible 编译器，你需要用
下面的命令：
CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
或者用系统提供的‘env’命令，如下：
env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
功能参数
=================
EMC 只有在 Real-Time （实时）系统上，才能控制操作硬件。 要么用 RTLinux 要么用 RTAI.
如果没有安装，EMC 就不能控制任何机器，请安装好其中的一个，（顺便共享一下过程给其他人）
不管怎样，EMC 也可以在没有 RT（实时）的系统中测试， 这需要用模拟模式, 它不需要控制硬件。
你需要用 '--enable-simulator' 选项来启用模拟模式。
如果在你的 /usr/src 中有多个 RTAI 或 RTLinux 版本，你要用下面的参数来选定正确的一个：
./configure --with-rtai=/usr/src/rtai-24.1.12
如果你仅想在此地测试（不安装），请用下面的参数：
--enable-run-in-place 在当前文件夹中运行（不安装到系统）
如果你不需要生成用文档，请用下面的参数：
--disable-build-documentation 不自动构建文档
configure 还可接受其它参数。 用 --help 获取参数清单.
--with-realtime= RTAI 或 RTLINUX 的安装目录
--enable-simulator 启动模拟器
--with-module-dir= 内核模块目录
--with-gtk_ver= GTK 版本
--with-kbuild= Specify if your kernel uses kbuild or not
--with-rmmod= rmmod variant
--with-insmod= insmod variant
--with-python= Specify the Python interpreter
--with-tclConfig= Specify the path to tclConfig
--with-tkConfig= Specify the path to tkConfig
--with-x use the X Window System
--with-locale-dir=DIR Location of the locale file(s)
DATADIR/locale
控制参数
==================
`configure' 要用下面参数来控制它的动作
`--cache-file=FILE'
Use and save the results of the tests in FILE instead of
`./config.cache'. Set FILE to `/dev/null' to disable caching, for
debugging `configure'.
`--help'
简单显示 ‘configure’的所有参数
`--quiet'
`--silent'
`-q'
Do not print messages saying which checks are being made. To
suppress all normal output, redirect it to `/dev/null' (any error
messages will still be shown).
`--srcdir=DIR'
Look for the package's source code in directory DIR. Usually
`configure' can determine that directory automatically.
`--version'
Print the version of Autoconf used to generate the `configure'
script, and exit.
翻译：gnix_oag
Email:gnix.oag@gmail.com
正式安装
-----------------
在标准的 Linux 操作系统上，按下面的过程编译安装:
从顶录录进入到源文件目录:
cd src
在源文件目录中，构建安装EMC2:
./configure
make clean
make
sudo make install
然后输入emc来运行它。
测试安装
-------
如果你想在安装前测试它,或者你担心它会覆盖了已安装好的，可用此方法来测试
你将使用 Run-In-Place （RIP）方式安装:
从顶目录进入到源文件夹:
cd src
在源文件夹中，用（RIP）方式编译安装:
./configure --enable-run-in-place
make clean
make
sudo make setuid
然后返回顶文件夹中，输入下行去运行EMC2：
scripts/emc
详细描述
====================
执行脚本
===============
本软件的运行脚本是 emc ，在安装好的系统上输入 ‘emc’ 来运行。
在 Run-In-Place 方式安装的系统上，(例刚从 CVS 仓库中下载测试),
测运行它要输入路径：
emc2/scripts/emc
如果你刚从CVS中下载,则没有‘scripts/emc’文件，只compilation有‘scripts/emc.in’。
配置程序将跟据它来生成‘scripts/emc’，其实它只是修改其中的某些默认值（文件夹、路径等）。
配置脚本
================
配置脚本‘configure’通过测试而设定适当的值来用于编译安装，它把这些值新建在 ‘Makefile.inc’ 文件中。
然后，它创建‘config.status’脚本,用于以后重建当前的配置文件，
‘config.cache’缓存了测试结果，可更快地重建配置，
‘config.log’记录测试日志（主要用于调试‘configure’）
‘configure.ini’文件用于‘autoconf’程序来创建‘configure’脚本，如果你要用‘autoconf’程序，改变或重建一个新的版本，只需要‘configure.in’文件。
下面简单介绍编译本软件的方法:
1. `cd' 进行到源文件夹中，输入 `./configure' 将根据你的环境进行配置， 如果你用的是
‘csh’ 解析器，你需要输入 `sh ./configure' 即用‘sh’替代‘csh’。
‘configure' 需要花一些时间，运行时，它会输出所检查内容的信息。
2. 输入‘make’开始编译软件。
3. 输入 ‘scripts/emc’测试本软件 。
编译及选项
=====================
有些平台的编译器和链接器需要一些罕见的参数，而‘configure’并不知道需要这些参数，
所以你要在环境变量中设定好这初始参数。 例如用 Bourne-compatible 编译器，你需要用
下面的命令：
CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
或者用系统提供的‘env’命令，如下：
env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
功能参数
=================
EMC 只有在 Real-Time （实时）系统上，才能控制操作硬件。 要么用 RTLinux 要么用 RTAI.
如果没有安装，EMC 就不能控制任何机器，请安装好其中的一个，（顺便共享一下过程给其他人）
不管怎样，EMC 也可以在没有 RT（实时）的系统中测试， 这需要用模拟模式, 它不需要控制硬件。
你需要用 '--enable-simulator' 选项来启用模拟模式。
如果在你的 /usr/src 中有多个 RTAI 或 RTLinux 版本，你要用下面的参数来选定正确的一个：
./configure --with-rtai=/usr/src/rtai-24.1.12
如果你仅想在此地测试（不安装），请用下面的参数：
--enable-run-in-place 在当前文件夹中运行（不安装到系统）
如果你不需要生成用文档，请用下面的参数：
--disable-build-documentation 不自动构建文档
configure 还可接受其它参数。 用 --help 获取参数清单.
--with-realtime=
--enable-simulator 启动模拟器
--with-module-dir=
--with-gtk_ver=
--with-kbuild=
--with-rmmod=
--with-insmod= insmod variant
--with-python=
--with-tclConfig=
--with-tkConfig=
--with-x use the X Window System
--with-locale-dir=DIR Location of the locale file(s)
DATADIR/locale
控制参数
==================
`configure' 要用下面参数来控制它的动作
`--cache-file=FILE'
Use and save the results of the tests in FILE instead of
`./config.cache'. Set FILE to `/dev/null' to disable caching, for
debugging `configure'.
`--help'
简单显示 ‘configure’的所有参数
`--quiet'
`--silent'
`-q'
Do not print messages saying which checks are being made. To
suppress all normal output, redirect it to `/dev/null' (any error
messages will still be shown).
`--srcdir=DIR'
Look for the package's source code in directory DIR. Usually
`configure' can determine that directory automatically.
`--version'
Print the version of Autoconf used to generate the `configure'
script, and exit.
翻译：gnix_oag
Email:gnix.oag@gmail.com
2008年2月11日星期一
README_zh_CN
http://cvs.linuxcnc.org/cvs/emc2/docs/src/README
关于EMC2文献的笔记：
在EMC2的makefile中可选择从此文件夹中的lyx和其它文件生成手册。
使用方法：在emc2/src中调用“./configure --enable-build-documentation”，再运行“make”。
使用的LyX的版本：
LyX文档在Ubuntu Dapper上需要适当版本的lyx来转换到html。这个版本是“version 221”。
在新版本的系统上，我发现，只要是在转换成211格式前，文件可任意编辑。
下面的命令可完成转换：
/usr/share/lyx/lyx2lyx/lyx2lyx --to 221 example.lyx > example.tmp.lyx
（检查example.tmp.lyx文件是不是好的）
mv example.tmp.lyx example.lyx
关于图画的笔记：
许多lyx文件使用了图画。大多数，使用EasyCad（一个非自由的Windows程序）生成原始文件，再导
出成.eps格式，最后再被包含在lyx文件中。但原始文件（EasyCad .FC7格式）不能在自由的系统上
使用。要解决这个问题，可把所有的原始文件转换成.dxf文件，并添加到仓库中。.dxf文件可被多个
CAD软件编辑，并可作为将来改变图画的源文件。他们可以使用Qcad转换成PostScript(PostScript
页面描述语言,不是.eps)，Qcad在Ubuntu中是可用的，(我也相信在debian中也是可用的)
不幸地，Qcad不能导入一些EasyCAD(和AutoCAD)支持的实体。包括一些在EMC2图中使用的：
填充，实心箭头，粗实线，虚线。QCAD把填充生成空的，把所有的线生成同一宽度，把虚线生成
实线，除非您告诉它怎么做。所有的这些使图画不漂亮，但还是可以接受的。然而， Qcad根本不
能导入实心箭头，严重影响图画的质量。在导出他们之前。因此EasyCad被用于把实心箭头转换
成空心箭头，虽然空心箭头没有实心箭头好看，但是至少他们是可看见的。
一旦导出，箭头会丢失他们的与线之间的关联，如果线动了，则箭头需要手动地进行移动/或转动。
我相信，即使他们被导回到EasyCad，线与箭头的关联依然是打破的。 在Qcad中可用“引线”的
尺寸标注工具生成新的箭头。
由于具有填充、宽线和虚线的原始的EPS文件更好看，他们将继续保持在CVS仓库中，并且继续用于文档中，
然而，如果由于软件本身的变化使他们不准确了，我们将必须编辑DXF文件，较不俏丽但事实上更准确地生
成postscript图。
自从Qcad成为一个视窗的应用程序，把dxf转换成PostScript就只要点几下即可，它不能自动的，也不能
更新makefile。并且，不是所有人在他的系统中安装了Qcad。所以，我们在CVS库中DXF和PostScript
两种文件，但生成标准文档的程序只用到PostScript文档。当dxf文件被编辑后，他们需要手动地被转换
成PostScript格式。转换过程如下：
打开Qcad
文件->打开-> 选择def文件
图形出现在窗口中
编辑->当前图画属性->页面
设置图纸为A4，根据图形的外观比例设置方向为横向或纵向
文件->打印预览
在工具档上单击“适合页面”（在Qcad v2.0.4.0的最右边）
文件->打印
选择“打印到文件”
设置到与源文件相同的文件夹
设置与原文件相同的文件名，但扩展名为.ps
单击确定
Qcad制造商也有一个GPL的格式转换程序叫vec2web，它能在命令模式下把dxf转换成PostScript。
它没有被编译打包，但我们可以从 http://www.ribbonsoft.com/vec2web.html 获取源代码。
编译vec2web需要依赖qt3开发工具包，但它不属于EMC构建文档。如果是在安装vec2web的
系统上配置好它，则能更好的自动转换dxf到ps。
要安装vec2web，不能不 sudo apt-get install qt3-dev-tools
vec2web包中包含一个构建脚本，在运行它前必须设置$QTDIRD变量为你的QT3安装目录，在我的实例中是：
export QTDIR=/usr/share/qt3
然后运行构建脚本：
./build_vec2web.sh
没有其它的安装步骤，就在构建文件夹中获得了可执行文件。
它没有使用手册，但不带任何参数地运行它，会提示使用方法：
Usage: vec2web
关于EMC2文献的笔记：
在EMC2的makefile中可选择从此文件夹中的lyx和其它文件生成手册。
使用方法：在emc2/src中调用“./configure --enable-build-documentation”，再运行“make”。
使用的LyX的版本：
LyX文档在Ubuntu Dapper上需要适当版本的lyx来转换到html。这个版本是“version 221”。
在新版本的系统上，我发现，只要是在转换成211格式前，文件可任意编辑。
下面的命令可完成转换：
/usr/share/lyx/lyx2lyx/lyx2lyx --to 221 example.lyx > example.tmp.lyx
（检查example.tmp.lyx文件是不是好的）
mv example.tmp.lyx example.lyx
关于图画的笔记：
许多lyx文件使用了图画。大多数，使用EasyCad（一个非自由的Windows程序）生成原始文件，再导
出成.eps格式，最后再被包含在lyx文件中。但原始文件（EasyCad .FC7格式）不能在自由的系统上
使用。要解决这个问题，可把所有的原始文件转换成.dxf文件，并添加到仓库中。.dxf文件可被多个
CAD软件编辑，并可作为将来改变图画的源文件。他们可以使用Qcad转换成PostScript(PostScript
页面描述语言,不是.eps)，Qcad在Ubuntu中是可用的，(我也相信在debian中也是可用的)
不幸地，Qcad不能导入一些EasyCAD(和AutoCAD)支持的实体。包括一些在EMC2图中使用的：
填充，实心箭头，粗实线，虚线。QCAD把填充生成空的，把所有的线生成同一宽度，把虚线生成
实线，除非您告诉它怎么做。所有的这些使图画不漂亮，但还是可以接受的。然而， Qcad根本不
能导入实心箭头，严重影响图画的质量。在导出他们之前。因此EasyCad被用于把实心箭头转换
成空心箭头，虽然空心箭头没有实心箭头好看，但是至少他们是可看见的。
一旦导出，箭头会丢失他们的与线之间的关联，如果线动了，则箭头需要手动地进行移动/或转动。
我相信，即使他们被导回到EasyCad，线与箭头的关联依然是打破的。 在Qcad中可用“引线”的
尺寸标注工具生成新的箭头。
由于具有填充、宽线和虚线的原始的EPS文件更好看，他们将继续保持在CVS仓库中，并且继续用于文档中，
然而，如果由于软件本身的变化使他们不准确了，我们将必须编辑DXF文件，较不俏丽但事实上更准确地生
成postscript图。
自从Qcad成为一个视窗的应用程序，把dxf转换成PostScript就只要点几下即可，它不能自动的，也不能
更新makefile。并且，不是所有人在他的系统中安装了Qcad。所以，我们在CVS库中DXF和PostScript
两种文件，但生成标准文档的程序只用到PostScript文档。当dxf文件被编辑后，他们需要手动地被转换
成PostScript格式。转换过程如下：
打开Qcad
文件->打开-> 选择def文件
图形出现在窗口中
编辑->当前图画属性->页面
设置图纸为A4，根据图形的外观比例设置方向为横向或纵向
文件->打印预览
在工具档上单击“适合页面”（在Qcad v2.0.4.0的最右边）
文件->打印
选择“打印到文件”
设置到与源文件相同的文件夹
设置与原文件相同的文件名，但扩展名为.ps
单击确定
Qcad制造商也有一个GPL的格式转换程序叫vec2web，它能在命令模式下把dxf转换成PostScript。
它没有被编译打包，但我们可以从 http://www.ribbonsoft.com/vec2web.html 获取源代码。
编译vec2web需要依赖qt3开发工具包，但它不属于EMC构建文档。如果是在安装vec2web的
系统上配置好它，则能更好的自动转换dxf到ps。
要安装vec2web，不能不 sudo apt-get install qt3-dev-tools
vec2web包中包含一个构建脚本，在运行它前必须设置$QTDIRD变量为你的QT3安装目录，在我的实例中是：
export QTDIR=/usr/share/qt3
然后运行构建脚本：
./build_vec2web.sh
没有其它的安装步骤，就在构建文件夹中获得了可执行文件。
它没有使用手册，但不带任何参数地运行它，会提示使用方法：
Usage: vec2web
订阅：
博文 (Atom)