Debian Codegraph @

contrib/plan9/README

raw
1 Mercurial for Plan 9 from Bell Labs
2 ===================================
3
4 This directory contains support for Mercurial on Plan 9 from Bell Labs
5 platforms. It is assumed that the version of Python running on these
6 systems supports the ANSI/POSIX Environment (APE). At the time of this
7 writing, the bichued/python port is the most commonly installed version
8 of Python on these platforms. If a native port of Python is ever made,
9 some minor modification will need to be made to support some of the more
10 esoteric requirements of the platform rather than those currently made
11 (cf. posix.py).
12
13 By default, installations will have the factotum extension enabled; this
14 extension permits factotum(4) to act as an authentication agent for
15 HTTP repositories. Additionally, an extdiff command named 9diff is
16 enabled which generates diff(1) compatible output suitable for use with
17 the plumber(4).
18
19 Commit messages are plumbed using E if no editor is defined; users must
20 update the plumbed file to continue, otherwise the hg process must be
21 interrupted.
22
23 Some work remains with regard to documentation. Section 5 manual page
24 references for hgignore and hgrc need to be re-numbered to section 6 (file
25 formats) and a new man page writer should be written to support the
26 Plan 9 man macro set. Until these issues can be resolved, manual pages
27 are elided from the installation.
28
29 Basic install:
30
31 % mk install # do a system-wide install
32 % hg debuginstall # sanity-check setup
33 % hg # see help
34
35 A proto(2) file is included in this directory as an example of how a
36 binary distribution could be packaged, ostensibly with contrib(1).
37
38 See https://mercurial-scm.org/ for detailed installation
39 instructions, platform-specific notes, and Mercurial user information.