如何在 groff man 宏中控制標題的內容

我使用 groff man 宏來生成通用文件（實際上不是手冊頁），因為它們易於學習和使用。不過，我希望將 postscript 頁面標題控制為自由文本。

groff 手冊說：

使用文件 man.local 對 man 宏進行本地擴展或更改樣式。

宏：.PT

控制標題的內容。通常，標題在兩邊列印命令名稱和節號，在中間列印可選的第五個參數 TH。

我如何在實踐中做到這一點？

措辭晦澀難懂，但建議是修改man.local文件本身，而不是覆蓋該文件中的宏。

一個很好的起點是文件：5.21 編寫宏（GNU Troff 手冊）。這顯示瞭如何定義宏。

要研究的實際宏嚴重依賴於版本。在 Debian 中，我在包中找到PT宏，在groff-base

/usr/share/groff/1.21/tmac/an-old.tmac

作為

.\" Redefine these to customize the header & footer
.
.de1 PT
.  tl '\\*[an-title](\\*[an-section])'\\*[an-extra3]'\\*[an-title](\\*[an-section])'
..

它將命名變數作為第一個參數傳遞給.tl. 要查看什麼.tl是（grep 是您的朋友）以及它的作用需要一些工作（在此處提到）：

你知道.tl(title) 由左、中、右三個部分組成嗎？

另一方面，多年來 groff 的文件有所改進：您可以在index中找到“.tl” 。

通常，您會發現：

• 大多數宏（您在閱讀這些文件時遇到的）都沒有記錄
• grep 遍歷宏列表（grep-w幫助）是找到特定宏的唯一方法
• 某些宏的設備特定版本會覆蓋通用版本

引用自：https://unix.stackexchange.com/questions/241274