Manpage updates (#19)

* ldid.zh_TW.1, ldid.zh_CN.1: Documents about new -P functionality
and many grammatical, pharsing, formatting and punctuation fixes

* docs: Document setting platform with -P is a Procursus extension

* docs: Document using -arch and -e together

diff --git a/docs/ldid.1 b/docs/ldid.1
index 2f130689fc8e5aa60f5b5c39f37d72680cc1adda..4c736108f37ec1a987f27d994df1ffbc06e0b914 100644 (file)
--- a/docs/ldid.1
+++ b/docs/ldid.1
@@ -74,7 +74,9 @@ in the special codesign slot at
 .Ar num .
 .It Fl e
 Print the entitlements in each slice, or the slice specified by
-.Fl A ,
+.Fl A
+or
+.Fl arch
 to
 .Ar stdout .
 .It Fl H Ns Op Ar sha1 | Ar sha256
@@ -112,6 +114,9 @@ If
 .Ar num
 is specified, the platform field in the CodeDirectory will be set to that number.
 The default is 13, as per Apple binaries.
+Specifying the platform to set to using
+.Fl P
+is a Procursus extension.
 .It Fl Q Ns Ar requirements.xml
 Embed the requirements found in
 .Ar requirements .

diff --git a/docs/ldid.zh_CN.1 b/docs/ldid.zh_CN.1
index ec1ecbbf1ea417073f3fe1293ad8371eb361917e..c7736e194e819f08b43fcc62dee6ca58ee63fc5a 100644 (file)
--- a/docs/ldid.zh_CN.1
+++ b/docs/ldid.zh_CN.1
@@ -20,15 +20,15 @@
 .Op Fl H Ns Op Ar sha1 | Ar sha256
 .Op Fl h
 .Op Fl I Ns Ar 名称
-.Op Fl K Ns Ar å¯\86é\8c\80.p12 Op Fl U Ns Ar 密码
+.Op Fl K Ns Ar å¯\86é\92¥.p12 Op Fl U Ns Ar 密码
 .Op Fl M
-.Op Fl P
+.Op Fl P Ns Op Ar 数字
 .Op Fl Q Ns Ar 需求
 .Op Fl q
 .Op Fl r | Fl S Ns Ar 档案.xml | Fl s
 .Op Fl u
 .Op Fl arch Ar 架构类型
-.Ar
+.Ar 档案......
 .Sh 描述
 .Nm
 把SHA1和SHA256杂凑值加入到Mach-O档案中，
@@ -36,9 +36,17 @@
 .Bl -tag -width -indent
 .It Fl A Ns Ar 处理器类型 : Ns Ar 亚类型
 当和
-.Fl a , Fl D , Fl e , Fl h , Fl q ,
+.Fl a
+、
+.Fl d
+、
+.Fl e
+、
+.Fl h
+、
+.Fl q
 或
-.Fl u ,
+.Fl u
 一起被使用时，只作用在被
 .Ar 处理器类型
 和
@@ -55,7 +63,7 @@
 .Fl A
 一样，不过使用架构的名称。
 已知的
-.Ar 架构类型 Ns s
+.Ar 架构类型 Ns
 可以在
 .Xr arch 3
 中找到。
@@ -76,10 +84,13 @@
 .Ar 数字
 的特殊代码签署位置中。
 .It Fl e
-把每一部分的权限印出， 或印出
-.Fl A ,
-所指定的部分的权限
-.Ar 到标准输出。
+把每一部分的权限印出，或印出
+.Fl A
+或
+.Fl arch
+所指定的部分的权限到
+.Ar 标准输出
+。
 .It Fl H Ns Op Ar sha1 | Ar sha256
 禁用没有指明的杂凑吗。
 这个选项可以用来重现
@@ -88,26 +99,35 @@
 .It Fl h
 印出关于签署的资讯，包括杂凑值的
 类型，选项，CDHash, 和 CodeDirectory 版本到
-.Ar 标准输出。
+.Ar 标准输出
+。
 .It Fl I Ns Ar 名称
 把二进制档案签署中的识别码设定为
-.Ar 名称。
+.Ar 名称
+。
 如没有指明，就会使用二进位档案的档案名称。
-.It Fl K Ns Ar å¯\86é\8c\80.p12
-用在
-.Ar å¯\86é\8c\80.p12 .
-的身份签署。 会给二进位档案有一个有效的签署，令它能够在有签署验证的系统上运行。
+.It Fl K Ns Ar å¯\86é\92¥.p12
+使用位于
+.Ar å¯\86é\92¥.p12
+的身份签署。会给二进位档案有一个有效的签署，令它能够在有签署验证的系统上运行。
 如果
-.Ar å¯\86é\8c\80.p12
-有密码的话，你会被询问。 也可以用
+.Ar å¯\86é\92¥.p12
+有密码的话，你会被询问。也可以用
 .Fl U
 选项来提供密码。
 .It Fl M
 当和
-.Fl S ,
-一起使用时，和现有的权限合并而不是取代它。 在加入权限时有用。
-.It Fl P
-将这个Mach-O二进位档案标示为系统二进位档案。
+.Fl S
+一起使用时，和现有的权限合并而不是取代它。在加入权限时有用。
+.It Fl P Ns Op Ar 数字
+将这个Mach-O二进位档案标示为平台二进位档案。
+如果提供了
+.Ar 数字
+，那么在CodeDirectory中的平台区域定会被设定为该数字。
+根据苹果的二进位档案，预设为13。
+使用
+.Fl P
+来设定平台是一个Procursus扩展。
 .It Fl Q Ns Ar 需求
 把需求嵌入到
 .Ar 需求
@@ -144,46 +164,47 @@
 .Pp
 指令：
 .Pp
-.Dl "ldid -Cadhoc -K/path/to/å¯\86é\8c\80.p12 -Sent.xml 档案"
+.Dl "ldid -Cadhoc -K/path/to/å¯\86é\92¥.p12 -Sæ\9d\83é\99\90.xml 档案"
 .Pp
 会使用
-.Ar /path/to/å¯\86é\8c\80.p12
+.Ar /path/to/å¯\86é\92¥.p12
 中的私錀来签署
 .Ar 档案
 也会使用在
-.Ar ent.xml ,
+.Ar 权限.xml
 中的权限并把签署标示为特别用途 (adhoc) 签署。
 .Pp
-指令:
+指令：
 .Pp
-.Dl "ldid -Sent.xml -M 档案"
+.Dl "ldid -S权限.xml -M 档案"
 .Pp
 会把
-.Ar ent.xml
+.Ar 权限.xml
 中的权限加入到已经在
-.Ar 档案 .
+.Ar 档案
 中的权限。
 .Pp
-指令:
+指令：
 .Pp
-.Dl "ldid -e 档案 > ent.xml"
+.Dl "ldid -e 档案 > 权限.xml"
 .Pp
 会把在
 .Ar 档案
 中每一部分的权限储存到
-.Ar ent.xml .
+.Ar 权限.xml
+。
 .Sh 另见
 .Xr codesign 1
 .Sh 历史
 这个
 .Nm
 工具程式是由
-.An Jay \*qSaurik\*q Freeman . 所编写的。
+.An Jay \*qSaurik\*q Freeman 所编写的。
 对iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6号被加入。
 .Fl S
 在2008年6月13日被加入。
 SHA256 支援在2016年8月25日被加入，修正iOS 11支援。
 iOS 14支援在2020年7月31日由
-.An Kabir Oberai .
+.An Kabir Oberai
 加入。
 iOS 15支援在2021年6月11日被加入。

diff --git a/docs/ldid.zh_TW.1 b/docs/ldid.zh_TW.1
index d675d19260e077abc8ed405516a5b1db95e0c031..9dc80ae2609273edaa6303d1a978b63ee5193a6f 100644 (file)
--- a/docs/ldid.zh_TW.1
+++ b/docs/ldid.zh_TW.1
@@ -22,13 +22,13 @@
 .Op Fl I Ns Ar 名稱
 .Op Fl K Ns Ar 密錀.p12 Op Fl U Ns Ar 密碼
 .Op Fl M
-.Op Fl P
+.Op Fl P Ns Op Ar 數字
 .Op Fl Q Ns Ar 需求
 .Op Fl q
 .Op Fl r | Fl S Ns Ar 檔案.xml | Fl s
 .Op Fl u
 .Op Fl arch Ar 架構類型
-.Ar
+.Ar 檔案......
 .Sh 描述
 .Nm
 把SHA1和SHA256雜湊值加入到Mach-O檔案中，
@@ -36,9 +36,17 @@
 .Bl -tag -width -indent
 .It Fl A Ns Ar 處理器類型 : Ns Ar 亞類型
 當和
-.Fl a , Fl D , Fl e , Fl h , Fl q ,
+.Fl a
+、
+.Fl d
+、
+.Fl e
+、
+.Fl h
+、
+.Fl q
 或
-.Fl u ,
+.Fl u
 一起被使用時，只作用在被
 .Ar 處理器類型
 和
@@ -55,7 +63,7 @@
 .Fl A
 一樣，不過使用架構的名稱。
 已知的
-.Ar 架構類型 Ns s
+.Ar 架構類型 Ns
 可以在
 .Xr arch 3
 中找到。
@@ -76,10 +84,13 @@
 .Ar 數字
 的特殊代碼簽署位置中。
 .It Fl e
-把每一部分的權限印出， 或印出
-.Fl A ,
-所指定的部分的權限
-.Ar 到標準輸出。
+把每一部分的權限印出，或印出
+.Fl A
+或
+.Fl arch
+所指定的部分的權限到
+.Ar 標準輸出
+。
 .It Fl H Ns Op Ar sha1 | Ar sha256
 禁用沒有指明的雜湊嗎。
 這個選項可以用來重現
@@ -88,14 +99,16 @@
 .It Fl h
 印出關於簽署的資訊，包括雜湊值的
 類型，選項，CDHash, 和 CodeDirectory 版本到
-.Ar 標準輸出。
+.Ar 標準輸出
+。
 .It Fl I Ns Ar 名稱
 把二進制檔案簽署中的識別碼設定為
-.Ar 名稱。
+.Ar 名稱
+。
 如沒有指明，就會使用二進位檔案的檔案名稱。
 .It Fl K Ns Ar 密錀.p12
-用在
-.Ar 密錀.p12 .
+使用位於
+.Ar 密錀.p12
 的身份簽署。會給二進位檔案有一個有效的簽署，令它能夠在有簽署驗證的系統上運行。
 如果
 .Ar 密錀.p12
@@ -104,10 +117,17 @@
 選項來提供密碼。
 .It Fl M
 當和
-.Fl S ,
+.Fl S
 一起使用時，和現有的權限合併而不是取代它。在加入權限時有用。
-.It Fl P
-將這個Mach-O二進位檔案標示為系統二進位檔案。
+.It Fl P Ns Op Ar 數字
+將這個Mach-O二進位檔案標示為平台二進位檔案。
+如果提供了
+.Ar 數字
+，那麼在CodeDirectory中的平台區域定會被設定為該數字。
+根據蘋果的二進位檔案，預設為13。
+使用
+.Fl P
+來設定平台是一個Procursus擴展。
 .It Fl Q Ns Ar 需求
 把需求嵌入到
 .Ar 需求
@@ -144,46 +164,47 @@
 .Pp
 指令：
 .Pp
-.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -Sent.xml 檔案"
+.Dl "ldid -Cadhoc -K/path/to/密錀.p12 -S權限.xml 檔案"
 .Pp
 會使用
 .Ar /path/to/密錀.p12
 中的私錀來簽署
 .Ar 檔案
 也會使用在
-.Ar ent.xml ,
+.Ar 權限.xml
 中的權限並把簽署標示為特別用途 (adhoc) 簽署。
 .Pp
-指令:
+指令：
 .Pp
-.Dl "ldid -Sent.xml -M 檔案"
+.Dl "ldid -S權限.xml -M 檔案"
 .Pp
 會把
-.Ar ent.xml
+.Ar 權限.xml
 中的權限加入到已經在
-.Ar 檔案 .
+.Ar 檔案
 中的權限。
 .Pp
-指令:
+指令：
 .Pp
-.Dl "ldid -e 檔案 > ent.xml"
+.Dl "ldid -e 檔案 > 權限.xml"
 .Pp
 會把在
 .Ar 檔案
 中每一部分的權限儲存到
-.Ar ent.xml .
+.Ar 權限.xml
+。
 .Sh 另見
 .Xr codesign 1
 .Sh 歷史
 這個
 .Nm
 工具程式是由
-.An Jay \*qSaurik\*q Freeman . 所編寫的。
+.An Jay \*qSaurik\*q Freeman 所編寫的。
 對iPhoneOS 1.2.0 和 2.0 的支援在2008年4月6號被加入。
 .Fl S
 在2008年6月13日被加入。
 SHA256 支援在2016年8月25日被加入，修正iOS 11支援。
 iOS 14支援在2020年7月31日由
-.An Kabir Oberai .
+.An Kabir Oberai
 加入。
 iOS 15支援在2021年6月11日被加入。