source: general/prog/mercurial.xml@ e20b59be

10.0 10.1 11.0 11.1 7.10 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind lazarus nosym perl-modules qt5new trunk upgradedb xry111/intltool xry111/test-20220226
Last change on this file since e20b59be was e20b59be, checked in by Fernando de Oliveira <fernando@…>, 7 years ago
  • Update to libgusb-0.2.8.
  • Update to librsvg-2.40.12.
  • Update to dbus-1.10.6.
  • Update to mercurial-3.6.2.
  • Update to samba-4.3.2.
  • Update to libass-0.13.1.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@16704 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.7 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY mercurial-download-http "http://mercurial.selenic.com/release/mercurial-&mercurial-version;.tar.gz">
8 <!ENTITY mercurial-download-ftp " ">
9 <!ENTITY mercurial-md5sum "f1155a562652004f569e5564d3c82661">
10 <!ENTITY mercurial-size "4.4 MB">
11 <!ENTITY mercurial-buildsize "52 MB (with documentation, additional 297 MB for tests)">
12 <!ENTITY mercurial-time "less than 0.1 SBU (with documentation, additional 3.2 SBU for tests, using -j8)">
13]>
14
15<sect1 id="mercurial" xreflabel="Mercurial-&mercurial-version;">
16 <?dbhtml filename="mercurial.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>Mercurial-&mercurial-version;</title>
24
25 <indexterm zone="mercurial">
26 <primary sortas="a-mercurial">mercurial</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to Mercurial</title>
31
32 <para><application>Mercurial</application> is a distributed source control
33 management tool similar to <application>Git</application> and
34 <application>Bazaar</application>. <application>Mercurial</application> is
35 written in <application>Python</application> and is used by projects such as
36 Mozilla and Vim.</para>
37
38 &lfs78_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>Download (HTTP): <ulink url="&mercurial-download-http;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download (FTP): <ulink url="&mercurial-download-ftp;"/></para>
47 </listitem>
48 <listitem>
49 <para>Download MD5 sum: &mercurial-md5sum;</para>
50 </listitem>
51 <listitem>
52 <para>Download size: &mercurial-size;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated disk space required: &mercurial-buildsize;</para>
56 </listitem>
57 <listitem>
58 <para>Estimated build time: &mercurial-time;</para>
59 </listitem>
60 </itemizedlist>
61
62 <bridgehead renderas="sect3">Mercurial Dependencies</bridgehead>
63
64 <bridgehead renderas="sect4">Required</bridgehead>
65 <para role="required">
66 <xref linkend="python2"/>
67 </para>
68
69 <bridgehead renderas="sect4">Optional</bridgehead>
70 <para role="optional">
71 <xref linkend="git"/>,
72 <xref linkend="gnupg2"/> (<command>gpg2</command> with Python bindings),
73 <xref linkend="subversion"/> (with Python bindings),
74 <ulink url="https://launchpad.net/bzr">Bazaar</ulink>,
75 <ulink url="http://www.nongnu.org/cvs/">CVS</ulink>,
76 <ulink url="http://docutils.sourceforge.net/">Docutils</ulink> (required to build the documentation),
77 <ulink url="http://pypi.python.org/pypi/pyflakes">pyflakes</ulink>,
78 <ulink url="http://pygments.org/">pygments</ulink>, and
79 <ulink url="https://launchpad.net/pyopenssl">pyOpenSSL</ulink>
80
81 </para>
82
83 <para condition="html" role="usernotes">User Notes:
84 <ulink url="&blfs-wiki;/mercurial"/></para>
85
86 </sect2>
87
88 <sect2 role="installation">
89 <title>Installation of Mercurial</title>
90
91 <para>Build <application>Mercurial</application> by issuing the following
92 command:</para>
93
94<screen><userinput>make build</userinput></screen>
95
96 <para>To build the documentation (requires
97 <application>Docutils</application>), issue:</para>
98
99<screen><userinput>make doc</userinput></screen>
100
101 <para>Running the test suite is optional. If there are failures, e.g.
102 test-parse-date.t, those tests can be disabled. To test the results in the
103 subdiretory <filename class="directory">tests/tmp</filename>, skipping
104 failing tests, issue:</para>
105
106<screen><userinput>cat &gt; tests/blacklists/failed-tests &lt;&lt; "EOF"
107<literal># Test Failures
108 test-convert-svn-source.t
109 test-convert-hg-svn.t
110 test-gpg.t
111 test-largefiles-update.t</literal>
112EOF
113rm -rf tests/tmp &amp;&amp;
114TESTFLAGS="-j<replaceable>&lt;N&gt;</replaceable> --tmpdir tmp --blacklist blacklists/failed-tests" \
115make check</userinput></screen>
116
117 <para>where <replaceable>&lt;N&gt;</replaceable> is an integer between one
118 and the number of processor threads, inclusive. In order to investigate a
119 particular apparently failing test, e.g <quote>test-parse-date.t</quote>,
120 issue the following commands (notice that omitting <option>--debug</option>
121 sometimes modifies the result):</para>
122
123<screen><userinput>pushd tests &amp;&amp;
124rm -rf tmp &amp;&amp;
125./run-tests.py --debug --tmpdir tmp test-parse-date.t &amp;&amp;
126popd</userinput></screen>
127
128 <para>Install <application>Mercurial</application> by running the following
129 command (as <systemitem class="username">root</systemitem>):</para>
130
131<screen role="root"><userinput>make PREFIX=/usr install-bin</userinput></screen>
132
133 <para>If you built the documentation, install it by running the following
134 command (as <systemitem class="username">root</systemitem>):</para>
135
136<screen role="root"><userinput>make PREFIX=/usr install-doc</userinput></screen>
137
138 <para>After installed, two very quick and simple tests should run correctly.
139 First one needs some configuration:</para>
140
141<screen><userinput>cat &gt;&gt; ~/.hgrc &lt;&lt; "EOF"
142<literal>[ui]
143username = &lt;user_name&gt; &lt;your@mail&gt;</literal>
144EOF</userinput></screen>
145
146 <para>where you must replace &lt;user_name&gt; and &lt;your@mail&gt; (mail
147 is optional and can be omitted). With the user identity defined, run
148 <command>hg debuginstall</command> and several lines will be displayed,
149 the last one reading "no problems detected". Another quick and simple test
150 is just <command>hg</command>, which should output basic commands that can
151 be used with <command>hg</command>.</para>
152
153 </sect2>
154
155 <sect2 role="configuration">
156 <title>Configuring Mercurial</title>
157
158 <sect3 id="mercurial-config">
159 <title>Config Files</title>
160
161 <para>
162 <filename>/etc/mercurial/hgrc</filename>
163 </para>
164
165 <indexterm zone="mercurial mercurial-config">
166 <primary sortas="e-etc-mercurial-hgrc">/etc/mercurial/hgrc</primary>
167 </indexterm>
168
169 <para>
170 If you have installed the <xref linkend="cacerts"/> and you want
171 <application>Mercurial</application> to use them, as the
172 <systemitem class="username">root</systemitem> user:
173 </para>
174
175<screen role="root"><userinput>install -v -d -m755 /etc/mercurial &amp;&amp;
176cat &gt; /etc/mercurial/hgrc &lt;&lt; "EOF"
177<literal>[web]
178cacerts = /etc/ssl/ca-bundle.crt</literal>
179EOF</userinput></screen>
180
181 </sect3>
182
183 </sect2>
184
185 <sect2 role="content">
186 <title>Contents</title>
187
188 <segmentedlist>
189 <segtitle>Installed Programs</segtitle>
190 <segtitle>Installed Libraries</segtitle>
191 <segtitle>Installed Directories</segtitle>
192
193 <seglistitem>
194 <seg>
195 hg
196 </seg>
197 <seg>
198 several internal modules under
199 /usr/lib/python&python2-majorver;/site-packages/mercurial
200 </seg>
201 <seg>
202 /etc/mercurial and
203 /usr/lib/python&python2-majorver;/site-packages/{hgext,mercurial}
204 </seg>
205 </seglistitem>
206 </segmentedlist>
207
208 <variablelist>
209 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
210 <?dbfo list-presentation="list"?>
211 <?dbhtml list-presentation="table"?>
212
213 <varlistentry id="hg">
214 <term><command>hg</command></term>
215 <listitem>
216 <para>is the program file for mercurial.</para>
217 <indexterm zone="mercurial hg">
218 <primary sortas="b-hg">hg</primary>
219 </indexterm>
220 </listitem>
221 </varlistentry>
222
223 </variablelist>
224
225 </sect2>
226
227</sect1>
Note: See TracBrowser for help on using the repository browser.