2010年2月4日 星期四

mm 巨集

mm 巨集解說


--------------------------------------
.1C
回到單欄模式


--------------------------------------
.2C
進入雙欄模式


--------------------------------------
.AE
結束摘要,見 .AS


--------------------------------------
.AF [company name]
第一頁的另一種形式。將第一頁的 "/Subject/Date/From" 格式改掉。若有參數,則其它標題不受影響。若無參數則不印出 company name 和標題。


--------------------------------------
.AL [type][indent][1]
啟始一個字母或是數字列表。需指定該列表的名稱,種類(type)和縮排(indent)。若第三個參數是 1,則項目之間不加間隔。列表中的每個項目都以 .LI 來標記,而列表以 .LE 為結尾。預設為編號列表。預設縮排存於 Li 暫存器中。

Type
1              阿拉伯數字。
A              大寫字母。
a              小寫字母。
I              大寫羅馬數字。
i              小寫羅馬數字。


--------------------------------------
.AS [type][n]
開始 type 的簡述,縮排 n 格。只可用於 .TM .RP。以 .AE 結尾。

Type
1              簡述封面和第一頁。
2              簡述封面。
3              僅簡述檔案備忘錄的封面。


--------------------------------------
.AT title
在正式備忘錄中,作者的頭銜置於作者姓名之後。


--------------------------------------
.AU name
作者的姓名加上最多八個其他的項目。置於正式備忘錄開頭。


--------------------------------------
.AV name
備忘錄尾,給 name 簽名用的欄位。


--------------------------------------
.B [barg][parg] ...
barg 設定為粗體(nroff 中為底線),將 parg 設定為前一種字型 ; 最多 6 個參數。


--------------------------------------
.BE
最底區塊結尾。會在註腳後印出(若有的話),但在頁足碼之前印出。見 .BS


--------------------------------------
.BI [barg][iarg]
barg 設定為粗體(nroff 中的底線),iarg 為斜體 ; 最多可有 6 個參數。


--------------------------------------
.BL [indent][1]
建立無編號列表。設定縮排。預設縮排為 3,以 Pi 暫存器儲存。若第二個參數是 1,則不輸出項目間的空白行。


--------------------------------------
.BR [barg] [rarg]
barg 設為粗體(nroff 中的底線),rarg 設為 Roman


--------------------------------------
.BS
最底區塊開頭。在註腳之後(若有的話),足碼之前印出。以 .BE 結尾。


--------------------------------------
.CS [pgs] [other] [tot] [figs] [tbls] [ref]
正式備忘錄的封面資料。


--------------------------------------
.DE
.DS 開始的靜態顯示或是 .DF 開始的浮動顯示做結尾。


--------------------------------------
.DF [type] [mode] [rindent]

啟動浮動顯示。也就是說,如果目前要輸出的文字區塊大於這一頁所剩的空間,則這個區塊會放到下一頁去,而這個區塊之後的文字會先放到原先這一頁來。見 De Df 兩個暫存器。
預設的 type 無縮排 ; 預設的 mode no-fillrindent 為右縮排。以 .DE 來結束。

Type
L 0              無縮排(預設)。
I 1              標準縮排。
C 2              每行分別置中。
CB 3              將整個區塊置中。

Mode
N 0              No-fill(預設)。
F 1              填滿模式。


--------------------------------------
.DL [indent] [1]
建立標線列表。指定文字的縮排。標準縮排為 3,其值存於 Pi 暫存器中。若第二個參數為1,則不印出項目間的空白行。


--------------------------------------
.DS [type] [mode] [rindent]

啟動靜態顯示。也就是說,如果目前要輸出的文字區塊大於這一頁所剩的空間,則這個區塊會分為兩半,一半留在這一頁,而另一半則放在下一頁。預設的 type 無縮排 ; 預設的 modeno-fillrindent 為右縮排。以 .DE 來結束。


--------------------------------------
.EC [caption] [n] [flag]

方程式的說明。參數可以更動預設的編號。flag 指定 n 的使用方式。見 .EQ

Flag
0              n 放在數字之前(預設)。
1              n 放在數字之後。
2              n 來代替編號。


--------------------------------------
.EF['left'center'right']

將這個參數放在每一個偶數頁的最底端。分別向左、置中、向右對齊。


--------------------------------------
.EH['left'center'right']


將這個參數放在每一個偶數頁的最頂端。分別向左、置中、向右對齊。


--------------------------------------
.EN
結束方程式顯示。見 .EQ


--------------------------------------
.EQ [text]

定義要用 eqn 來處裡的方程式區塊開頭。text 用做標記(見 .EC)。以 .EN 結尾。有關 eqn請見第 16 章。


--------------------------------------
.EX [caption][n][flag]

顯示 caption。參數可用來改掉預設編號。flag 是用來指定 n 的用法。

Flag
0              n 放在數字之前(預設)。
1              n 放在數字之後。
2              n 來代替編號。


--------------------------------------
.FC [text]

text 用於正式文件結尾。


--------------------------------------
.FD[n]

將預設頁足碼格式設定為 nn 0 11


--------------------------------------
.FE
頁足碼結尾。見 .FS


--------------------------------------
.FG [title]
圖表的標題。


--------------------------------------
.FS [c]
c 用做頁足碼的起始字元。預設為編號足碼。以 .FE 結尾。


--------------------------------------
.H n [heading]

在第 n 層印出編號標題 headingn 1 7。詳見下列任一項:

暫存器
Ej              捲頁。
Hb              標題後斷行。
Hc              置中標題。
Hi              標題後第一段的類型。
Hs              標題後間隔。
Hu              無編號標題。

字串
HF              字型控制。
HP              點大小。

巨集
.HM              標題標記。
.HU              無編號標題。
.HX.HY.HZ
              使用者定義的巨集,會在輸出標題時執行。


--------------------------------------
.HC [c]
c 字元用做斷字符號。


--------------------------------------
.HM [mark]
標題標記為阿拉伯數字(1 001)、羅馬數字(i I)或是字母(a A)。


--------------------------------------
.HU heading
後面接無編號的heaeding(標題)。和 .H 一樣,但不印出編號。見 Hu 暫存器。


--------------------------------------
.HX
印標題之前執行的使用者巨集。


--------------------------------------
.HY
印標題時執行的使用者巨集。


--------------------------------------
.HZ
印標題之後執行的使用者巨集。


--------------------------------------
.I [iarg] [parg]
iarg 設定為斜體(nroff 中為底線),將 parg 設定為前一種字型 ; 最多 6 個參數。


--------------------------------------
.IA
收件者地址開頭。商業信件用,以 .IE 結尾。


--------------------------------------
.IB [iarg] [barg]
iarg 設定為斜體(nroff 中為底線),將 barg 設定粗體 ; 最多 6 個參數。


--------------------------------------
.IE
收件者地址結尾,見 .IA


--------------------------------------
.IR [iarg] [rarg]
iarg 設為斜體(nroff 中的底線),rarg 設為 Roman


--------------------------------------
.LB n m pad type [mark] [LI-space] [LB-space]

建立列表。可以完全控制列表的形態。每個項目都以 .LI 開始,以 .LE 結束。

n               縮排。
m              標記縮排。
pad              和標記相關的填補字元。
type              若是 0,則用指定的 mark。若非 0,則 mark 1AaIi,列表會自動進行編號。而 type 是用來控制 mark 的顯示方式。比如,若 mark 1,則 type 會有下列的結果:
 
Type              結果
  1                            1.
  2                            1)
  3                            (1)
  4                            [1]
  5                            <1>
  6                            {1}

mark                            用來標記每個項目的數字或是符號。mark 可以是 null,如此就會有縮排。也可以是字串或是 1AaI i 其中之一,這樣會進行自動編號。
LI-space              每個 .LI 巨集之間要插入多少空白行。預設為 1
LB-space              每個 .LB 巨集所要輸出的空白行,預設為 0


--------------------------------------
.LC [n]
清除至第 n 層的列表。


--------------------------------------
.LE [1]
.AL.BL.DL.LB.ML 或是 .VL 所開頭的區塊都以 .LE 結尾。若有參數 1,則在列表之後插入一行(.5v)。


--------------------------------------
.LI [mark] [1]
text

列表中的項目。必須先建立列表(見 .AL.B:.DL.LB.ML 或是 .VL)然後以 .LE 結尾。若指定 mark,則取代建立列表的巨集所指定的預設標記。若加上參數 1,則 mark 會加在現有標記之前。


--------------------------------------
.LO type [notation]

指定在商業信函中,以 notation 形式出現文字的 type 和字串。

Type
AT              注意。
CN              機密。
RN              參考文件。
SA              敬啟者。
SJ              主題。


--------------------------------------
.LT [type]

商業信件種類

Type
BL              擬定(預設)。
SB              部份擬定。
FB              完全擬定。
SP              簡化。


--------------------------------------
.ML mark [indent] [1]

建立列表。mark 可以為一個或多個字元。indent 控制縮排,預設為比 mark 長度多一格。若加上第三個參數,則項目間的間隔不會印出來。


--------------------------------------
.MT [type] [title]

指定備忘錄的類型和標題。這個巨集控制備忘錄的格式,但必須在 .TL.AF.AU.AS .AE等之後使用。使用者的 title 會放在頁碼之前。

Type
0              無。
1              檔案的備忘錄(預設)。
2              程式設計筆記。
3              工程筆記。
4              出版文件。
5              對外信函。
string              印出 string


--------------------------------------
.ND date

新日期,更改在備忘錄中出現的日期格式。


--------------------------------------
.NE

.NS,這是其結尾。


--------------------------------------
.nP

編號的段落,段落開頭有雙行縮排。見 .P


--------------------------------------
.NS [type]

註記開頭。和 .MT 1 .AS 2/.AE 合用來指定封面的註記。否則用在備忘錄最尾端。指定註記種類 type

Type
0              Copy to(預設)。
1              Copy(加上注意)to
2              Copy(無注意)to
3              Att
4              Atts
5              Enc
6              Encs
7               Under separate cover (另有不同封面)。
8              Letter to
9              Memorandum to
10              Copy (有 atts.to
11              Copy (無 atts.to
12              Abstract Only to
13              Complete Memorandum to
string              Copy string to


--------------------------------------
.OF ['left'center'right']
將這個參數放在每一個奇數頁的最底端。分別向左,置中,向右對齊。


--------------------------------------
.OH ['left'center'right']

將這個參數放在每一個奇數頁的最頂端。分別向左、置中、向右對齊。


--------------------------------------
.OK [topic]
其他關鍵字。指定 topic 出現在備忘錄的封面上。最多可用九個參數。


--------------------------------------
.OP
強迫產生奇數頁。


--------------------------------------
.P [type]

建一個新的段落。type 可以指定來更改預設值。可更改下列暫存器來控制預設值:

Pt              文件的段落種類(預設為 0)。
Pi              縮排(預設為 3)。
Ps              段落間距(預設為一行空白)。
Np              設為 1 可以產生編號段落。

Type

0              左對齊(預設)。
1              縮排。
2              除了 .DE .LE .H 之後均縮排。


--------------------------------------
.PF ['left'center'right']

將這個參數放在每頁的最底端。分別向左、置中、向右對齊。在字串中用 \\\\nP 來取得頁碼。見 .EF .OF


--------------------------------------
.PH ['left'center'right']


將這個參數放在每頁的最頂端。分別向左、置中、向右對齊。在字串中用 \\\\nP 來取得頁碼。見 .EH.OH


--------------------------------------
.PN [type]
每一頁上的專屬標記

Type

P              Private(私人)。
N              Notice(注意)。


--------------------------------------
.PX

頁標題跳出。恢復原環境後使用。見 .TP


--------------------------------------
.R

調回 Roman 字型(nroff 中結束底線)


--------------------------------------
.RB [rarg][barg]

rarg 設為 Romanbarg 設為粗體,最多六個參數。


--------------------------------------
.RD [prompt]
從終端機讀入輸入,加上 prompt 做為提示之用。


--------------------------------------
.RF
結束參考文字。見 .RS


--------------------------------------
.RI [rarg][barg]
rarg 設定為 Romanbarg 設定為斜體 ; 最多 6 個參數。


--------------------------------------
.RL [indent] [1]

建立參考列表,主要是以 [] 括起來的編號列表。指定縮排(indent),預設為 6,由 Li 暫存器儲存其值。若第二個參數是 1,則項目間無空白行。


--------------------------------------
.RP
建立參考頁。


--------------------------------------
.RS[n]
建立自動編號參考,可從 n 開始。由 .RF 結尾。


--------------------------------------
.S [±] [n] [±] [m]
將點大小設為 n,垂直行距設為 m(僅 troff)。或是可以用利用目前的值(C),預設值(D)或是前一個值(P)來作增減。


--------------------------------------
.SA [n]

將右邊界設定為 nnroff 預設為沒有右邊界,troff 預設為有。

n 之值:
0              不對齊。
1              對齊。


--------------------------------------
.SG [name]
name 當做簽名。


--------------------------------------
.SK n
跳過 n 頁。和 .bp request 相同。


--------------------------------------
.SM x [y z]
x 字串縮小一點。若也指定了 y z,則字串 y 縮小一點。


--------------------------------------
.SP [n]

輸出 n 個垂直行間距。兩個連續的 .SP 並不會累加效果。


--------------------------------------
.TB [title][n][flag]

建立表格 title。參數可更改預設編號。flag 用來指定 n 的用法。
Flag
0              n 放在數字之前(預設)。
1              n 放在數字之後。
2              n 來代替編號。


--------------------------------------
.TC [slevel] [spacing] [tlevel] [tab] [head1]...
從指定的格式中產生目錄。Cl 暫存器的值是用來指定目錄所須用的標題層數。

slevel 設定標題前要加上空白的層數。spacing 則指定留多少空白。預設為 1。第一層的標題之前會加上一行空白。

tlevel tab 用來指定頁數的位置。層數小於等於 tlevel 者的頁數會放在最右邊界上。不然,標題和頁數只以兩格空白隔開。若頁數在右方且 tab=0,則頁數和標題之間會以 "." 填滿。若 tab=1,則以空白填滿。


--------------------------------------
.TE

表格結尾。見 .TS


--------------------------------------
.TH [N]
表格檔頭的結尾。之前必須以 .TS H 做開頭。N 則強迫將表格檔頭放在新的一頁上。


--------------------------------------
.TL title
指定備忘錄的標題。


--------------------------------------
.TM [n]
指定備忘錄的號碼 n


--------------------------------------
.TP
頁首巨集。每建立一個新的頁就執行一次。當標題就是輸出時就會啟動。見 .PH


--------------------------------------
.TS [H]
建立以 tbl 處理的表格開頭。用 H 來將每一頁都加上表格檔頭。(用 .TH 結束檔頭)。用 .TE來做表格結尾。tbl 詳見第十六章。


--------------------------------------
.TX
印目錄標題之前執行的使用者巨集。


--------------------------------------
.TY
印目錄標題時執行的使用者巨集。


--------------------------------------
.VL n [m] [1]
建立列表。用來建立縮排或是標記的段落。將文字縮排 n 個空白,並將標記縮排 m 個空白。若有 1 為參數,則項目間不加空白行。每個項目以 .LI 開頭。整個列表以 .LE 做結尾。


--------------------------------------
.VM [n] [m]

在上邊界加 n 行,在下邊界加 m 行。


--------------------------------------
.WA

商業信件中發件者地址開頭,以 .WE 結尾。


--------------------------------------
.WE

商業信件中發件者地址結尾,以 .WE 開頭。


--------------------------------------
.WC [x]

將欄寬或是足碼寬設定為 x

x 之值:
FF              所有的足碼均相同。
-FF              關掉 FF 模式。
N              預設模式。
WD              寬顯示模式。
-WD              預設欄寬。
WF              寬足碼。
-WF              關掉 WF 模式。





內建字串名稱

BU              Bullet,點號,和 \(bu 同。
Ci              目錄階層所使用的縮排列表。
DT              目前日期。
EM              Em dash troff)。雙減號(nroff)。
F              足碼產生器。
HF              每層標題所用的字型(1=roman2=斜體、3=粗體)。
HP              每層標題所用的點大小。
Le              方程式表所使用的標題組。
Lf              圖表所使用的標題組。
Lt              表格所使用的標題組。
Lx              展示圖所使用的標題組。
RE              SCCS 版號和 mm 的階層。
Rf              參考號碼產生器。
Rp              參考所使用的標題組。
TM              商標字串。將 TM 加在商標後,並抬高半行。




暫存器

若在暫存器旁有十字號,則表示該暫存器 " 只能 " 在指令行或是讀入巨集定義之前更改。任何以單一字元構成的暫存器都可以由指令行參數 -r 來更改。

<<<<<<<<<< 排版請注意、左欄不翻、右欄用 -- 號分隔 >>>>>>>>>>>>>>>

              --
              若設定為 1,則略去技術性備忘錄的標題,並留空間放入信件檔頭。(見 .AF 巨集)。
              --
              第一頁不使用作者資料(見 .AU 巨集)。
              --
              指定文件的性質(原件,草稿等等)。
              --
              目錄用到的標題的層數(預設為 2) 見 .TC 巨集。
              --
              若設為 1(預設情況),則圖例列表也和目錄並列。否則置於新一頁中。
              --
             




              若設為 1,則為 debug 模式。(就算遇到錯誤也會繼續)。預設為 0
              --
              若設為 1,則每個浮動顯示後都直接跳頁,預設為 0
              --
              設定浮動顯示模式(見 .DF 巨集)。
              --
              設定靜態顯示前後所使用的間隔。
              --
              Subject/Date/From 所使用的字型。0(粗體,預設值)或是 1Roman)。
              --
              方程式計數器,每執行一次 .EC 就增加 1
              --
              要跳頁的標題階層。預設為 0,不跳頁。
              --
              若設為 1,則將方程式標記放在左邊界。預設為 0
              --
              展示圖計數器,每執行一次 .EX 巨集就加 1
              --
              圖表計數器,每執行一次 .FG 巨集就加 1
              --
              足碼之間的垂直間隔。
              --
              n1 7)層標題的計數器。執行同一層的 .H 就會加 1。或是由 .Hu 所指定的層所執行的 .Hu 也會增加計數。H2 H7 只要有較低層的 .H 執行就會重置為 0
              --
              輸出本文之前先斷行的標題層數,預設為 2
              --
              置中的標題層級,預設為 0
              --
              標題後的縮排方式。0 為左對齊,1 為縮排(預設),2 為除了 .H .LC .DE 以外均縮排。
              --
              標題後加上空白的層級數。預設為 2
              --
              標題的編號方式。1(單獨)或是 0(累加,預設)。
              --
              無編號標題的層級,預設為 2。見 .Hu 巨集。
              --
              若設為 1,則進行斷字。預設為 0
              --
              設定頁長。預設為 66v
              --
              是否要在目錄後印出方程式列表。0 為否(預設),1 為是。
              --
              Le 類似,但是對圖表而言。
              --
              列表的預設縮排,預設為 5
              --
              巢狀列表中項目間的間隔。預設為 6
              --
              Le 類似,但是對表格列表而言。
              --
              Le 類似,但是對展示圖而言。
              --
              設定頁編碼方式:
              0              每頁都有頁首(預設)。
              1              第一頁頁首印在最下面。
              2              第一頁沒有頁首。
              3              分節的頁中,頁首做足碼。
              4              除非使用 .PH,否則沒有頁首。
              5              分節與節的圖表頁的頁首當做足碼。
              --
              設定段落編號方式。0(不編號),或是 1(編號)。
              --
              頁偏移量。nroff 中為字元數,預設為 97.5i)。troff 中為 5i
              --
              設定目錄頁的編號方式 .0(小寫羅馬數字,預設)或是 1(阿拉伯數字)。
              --
             




設定圖表說明的分隔字元。預設為 0"."),或是 1(用斷字字元,hyphen)。
              --
              目前頁碼。
              --
              段落縮排。nroff 預設為 5troff 預設為 3
              --
              段落間距,預設為 3v
              --
              段落種類。0(左對齊,預設)、1(縮排)、2(除了 .H .LC .DE 之後都縮排)。
              --
              不印出 PRIVATE 檔頭。
              --
              參考計數器,每執行一次 .RS 就加 1
              --
              troff 的預設點大小。預設為 10。垂直間距為 \nS+2
              --
              顯示用的標準縮排。nroff 5troff 3
              --
              nroff 的輸出裝置。見裝置的暫存器。
              --
              表格計數器,每個 .TB 就加 1
              --
              nroff .H .HU 加底線的方式。若不設定則使用連續底線。若設定,則標點符號和空白處不加底線。
              --
              頁寬。(行與標題寬)。預設為 6i
             

其他保留字

mm 中,只有單一字元或是前一個字元是小寫字母,而後一個字元不是小寫字母的名字可以使用。不過 c2 nP 已經使用了。

沒有留言:

張貼留言

推到 Twitter!
推到 Plurk!
推到 Facebook!