Ticket #1594: README.tw

File README.tw, 5.0 KB (added by mjhsieh@…, 21 years ago)

The doc file

Line 
1DARWIN PORT 系統是什麼
2
3    DarwinPorts 的設計就是要提供類似 FreeBSD ports 的架構般的功能需求:當作為軟體編譯、
4    軟體安裝以及套件製作的基礎設施。此外,還須保持在將來改善時所需的擴充性。
5   
6    DarwinPorts 目前可在 MacOS X 10.2 (Darwin 6.0) 以及 MacOS X 10.3 下編譯及執行。系
7    統本身是用 TCL 語言及一些用 C 語言寫的 TCL 延伸模組所撰寫,所以也能夠移植到別處。
8   
9    "DarwinPort 使用者指南" 可以從以下網址取得。
10    http://www.opendarwin.org/projects/darwinports/guide/
11
12    如果想要找有關 ports 系統架構內部更深入的資料,請參閱 base/doc/INTERNALS 檔案。
13
14    請注意 DarwinPorts 分成兩部份:在 base/ 子目錄中的是 "Darwin ports 基礎";同時也是本
15    系統必要的部份。第二部份在 "dports" 目錄中包含了被移植軟體的真正敘述。後者是可另外選用並
16    且可以等到用的時候再連到網路上抓或自己存下來用。詳見以下 /etc/ports/source.conf 部份
17    相關說明。
18
19安裝
20
21        如要各別平台專門的安裝指引,請參閱 base/doc/README.platforms 檔案。
22
23    安裝步驟:
24
25        1. cd base/
26           ./configure
27                切換到 base/ 目錄,並執行 configure script。非必要的參數可以傳進 configure
28                script 裡(見下面說明)。
29   
30        2. make
31                執行 'make' 來編譯所需的軟體。
32               
33        3. sudo make install
34                執行 'sudo make install' 將 DarwinPorts 安裝到你的系統裡。
35
36        4.      [選用] edit /etc/ports/ports.conf
37                /etc/ports/port.conf 設定檔定義了 DarwinPorts 架構所需的幾個選項。
38                如果你希望更動安裝路徑,或是各個 port 系統的相關資料存放位置,請修改下列的設定:
39
40                portdbpath - 存放 ports 系統相關資料的路徑
41                prefix - 預設會將 ports 安裝到這個目錄下
42
43        5.      [選用] edit /etc/ports/sources.conf
44                /etc/ports/sources.conf 設定檔紀錄被移植軟體的敘述檔目錄在本地端與遠端位置。如
45                果沒有在 ./configure 中指定 --with-dports-dir=DIR 參數,sources.conf 會使
46                用預設的 dports 敘述檔目錄(darwinports/dports,即安裝時抓回來的 dports 路徑)。
47
48        所有必要的程式碼以及 TCL 指令會被編譯並安裝成以下的:
49        [Mac OS X 10.2] /System/Library/Tcl/darwinports1.0
50        [Mac OS X 10.3] /Library/Tcl/darwinports1.0
51        [FreeBSD] /usr/local/lib/tcl8.3/darwinports1.0
52                - 用來和 DarwinPorts 系統作中介的 TCL 程式庫
53
54        雖然 PREFIX 預設成 /opt/local,但是也可以更改為特定的 base/ 目錄,然後在手動執行
55        ./configure 時加上 --prefix 參數。
56
57        $PREFIX/bin/port
58            - 在命令列下的 port 工具
59        $PREFIX/share/darwinports/
60            - port 系統內的 TCL 程式庫
61       
62        以下的檔案可用來自定系統
63
64        /etc/ports/ports.conf
65            - 使用者可自定的 port 設定
66        /etc/ports/sources.conf
67            - ports 的原始碼列表 (取得 port 資料的地方)
68
69使用 port 命令
70
71    如果你還沒準備好,請將 /opt/local/bin 加到你的執行路徑 (path) 中 (或者,如果你選擇把
72    DarwinPorts 安裝在不同的地方,請把 $PREFIX/bin 加到執行路徑中。)
73
74    如果你不確定如何改變執行路徑,而且你是使用 Jaguar (OS X 10.2), 把下面這行加入到你的
75    ~/.cshrc 檔。 (如果你是在 Panther 中使用 tcsh,你也需要把下面這行加入到你的 ~/.cshrc
76    檔。)
77
78        set path=($path /opt/local/bin)
79       
80    如果你是使用 Panther (OS X 10.3), 把下面這行加入你的 ~/.profile 檔。 (如果你在 Jaguar
81    中是使用 bourne shell,你也需要把下面這行加入你的 ~/.profile 檔。)
82
83        export PATH=$PATH:/opt/local/bin
84
85    在重新執行一個新的 shell 之前,你所做的改變不會有任何作用。
86
87    下面的命令將會建立與安裝一個 port 套件:
88
89        port install <portname>
90
91    要找一個特定的 port 套件,可以試用 "port search" 如
92
93        port search vi
94
95    如要得到關於 port 指令的完整的文件,請參閱 port 的系統手冊 (man page)。
96
97    如使用 portall 命令就可以對所有的 port 同時做建立套件或是取得原始檔等等的操作。基本上,
98    portall 的參數與 port 命令是相同的,但 portall 會對所有在 dport/ 之下的 port 套件一
99    一執行所指定的特定操作。例如,當你在 dport/ 的目錄裡執行 "make clean" 時,"portall clean"
100    也會被呼叫出來把所有東西都清理的乾乾淨淨。
101
102建立新的 PORT
103
104    Port 是由 Portfile 檔與其他相關檔案及其目錄所組成。目前隨 port 內附的檔案只有修補檔,而且
105    原則是把檔案數目盡量減少。
106
107        Portfile 檔是由 TCL 指令組成,這些指令還要在 DarwinPorts 系統所用的 TCL 直譯器下測試過
108        沒問題才行。Portfile 檔案使用了極為直觀的鍵/對應值配對(key-value pairs)語法,這樣讓作
109        者必要時可以使用到全部 TCL 的功能。
110
111    新手可以參閱 base/doc/exampleport 檔案以及 portfile(7) 手冊。