文档中插入程序设计语言源代码.docVIP

LGrind宏包用于处理计算机程序源代码, 使之以漂亮的格式出现在文档 中. LGrind的前身是vgrind. 1 简介 1.1 LGrind? LGrind宏包有三个文件组成: #8226; lgrind或者lgrind.exe是可执行文件. 它可以将嵌入源代码的tex文件或者 程序源代码文件 例如cpp文件 转换为可以有LATEX处理的tex文件. #8226; lgrind.sty中提供了处理源代码需要的命令和宏. #8226; lgrindef提供了各种程序设计语言的关键字, 以及注释等的语法信息. 2 LGrind可执行程序使用说明 lgrind [?s] [?e] [?o ] [?n] [?c] [?t ] [-h ] [?v ] [?d[!] ] [?l ] [ | ?] LGrind处理输入文件, 然后将输出定向到标准输出. 输出可以保存以待后继 处理 包含在别的源文件中 . 运行选项: ?e 处理嵌入源代码的tex文件 ?i 输出将通过＼lgrindfile 命令包含在其他tex文件中 ? 将输入定向到标准输入 ?o 将输出定向到指定的文件 ?n 不加粗源代码中的关键字 ?a 在LATEX中将@等字符处理为文本而非LATEX命令 ?c 在源程序的注释中, 将@等字符处理为文本而非LATEX命令 1 ?t 改变tab的宽度 默认为8个字符 ?h specifies text to go on the left side of every output page default is none . 不 明白 ?d 使用不同的lgrindef文件 ?d! 同?d一样, 不过该选项会改变写入可执行文件内部的lgrindef文件的位置, 产生新的可执行文件. ?l 描述源代码中使用的程序设计语言 ?s 答应lgrind当前支持的程序设计语言 在默认情况下, LGrind以命令行上的文件作为输入文件, 将处理结果输出到 标准输出文件. 可以通过?和?o选项对输入输出进行重定向. 如果选项中既没有?e也没有?i选项, 那么将产生完整的tex文件. 如果选项中 没有描述程序设计语言, 那么LGrind将通过输入文件的扩展名确定输入文件中 所使用的程序设计语言. lgrindef文件中包含关于文件扩展名的表格, 如果输入 文件的扩展名在lgrindef文件中不存在, LGrind将默认输入文件是C语言源文件. 在没有任何参数的情况下运行lgrind可执行文件, 将打印简短的帮助信息. 可以通过三种方式描述所使用的lgrindef文件,使用?d选项,设置LGRINDEF环 境变量, 固定在lgrind可执行文件中的参数. 可以通过?d!选项产生新的可执行文 件以修改固定在可执行文件中的关于lgrindef文件的参数. lgrind所能够识别的程序设计语言定义在lgrindef文件中, 下面的表格包含了 当前版本所支持的语言. Ada LATEXa RATFOR Asm LDL RLaBb Asm68 Lex Russell BASICa Linda SASc Batchb Lisp Emacs Schemed C MASMa sh C++ MATLABa SICStusb csh MLd src FORTRAN Mercury SQL Gnuplote model Tcl/Tkf Icon Modula2 VisualBasica IDLg Pascal VMSasm ISP PERL yacc Java PostScript Kimwitu++ PROLOG 2.1 处理模式 LGrind一共有三种处理模式: stand?alone, included和embeded. 命令lgrind -o bary.tex bary.y将产生stand?alone类型的tex文件,用LATEX处 理bary.tex可以生成dvi文件. 2 命令lgrind -i -lc foo.c #1Array1; foo.tex将foo.c中的源代码转换为可以插入tex文 件中的tex文件.通过在doc.tex文件头中使用命令＼usepackage lgrind 引入lgrind宏 包, 然后在需要插入foo.c的源代码中的地方使用命令＼lgrind或者＼lgrindfile包 含foo.tex文件. 用latex处理doc.tex文件, 就可以得到漂亮的包含源代码的dvi文 件. ＼lgrind和＼lgrindfile命令的使用方法将在下一节中介绍. 最后是embeded模式 也许是最强大的模式 , 你可以在该模式的tex文件中 直接写源程序代码, 并使用命令: lgrind -e pretty?source.lg #1Array1; ev