/usr/share/doc/graphicsmagick/www/Hg.html is in graphicsmagick 1.3.28-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 | <?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.13.1: http://docutils.sourceforge.net/" />
<title>GraphicsMagick Mercurial</title>
<meta content="GraphicsMagick is a robust collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats including GIF, JPEG, PNG, PDF, and Photo CD. With GraphicsMagick you can create GIFs dynamically making it suitable for Web applications. You can also resize, rotate, sharpen, color reduce, or add special effects to an image and save your completed work in the same or differing image format. " name="description" />
<meta content="GraphicsMagick, PerlMagick, visualization, image processing, software development, simulation, image, software, Magick++" name="keywords" />
<link rel="stylesheet" href="docutils-articles.css" type="text/css" />
</head>
<body>
<div class="banner">
<img src="images/gm-107x76.png" alt="GraphicMagick logo" width="107" height="76" />
<span class="title">GraphicsMagick</span>
<form action="http://www.google.com/search">
<input type="hidden" name="domains" value="www.graphicsmagick.org" />
<input type="hidden" name="sitesearch" value="www.graphicsmagick.org" />
<span class="nowrap"><input type="text" name="q" size="25" maxlength="255" /> <input type="submit" name="sa" value="Search" /></span>
</form>
</div>
<div class="navmenu">
<ul>
<li><a href="index.html">Home</a></li>
<li><a href="project.html">Project</a></li>
<li><a href="download.html">Download</a></li>
<li><a href="README.html">Install</a></li>
<li><a href="Hg.html">Source</a></li>
<li><a href="NEWS.html">News</a> </li>
<li><a href="utilities.html">Utilities</a></li>
<li><a href="programming.html">Programming</a></li>
<li><a href="reference.html">Reference</a></li>
</ul>
</div>
<div class="document" id="graphicsmagick-mercurial">
<h1 class="title">GraphicsMagick Mercurial</h1>
<!-- -*- mode: rst -*- -->
<!-- This text is in reStucturedText format, so it may look a bit odd. -->
<!-- See http://docutils.sourceforge.net/rst.html for details. -->
<div class="contents topic" id="contents">
<p class="topic-title first">Contents</p>
<ul class="simple">
<li><a class="reference internal" href="#what-is-mercurial" id="id1">What is Mercurial?</a></li>
<li><a class="reference internal" href="#web-access" id="id2">Web Access</a></li>
<li><a class="reference internal" href="#cloning-the-mercurial-repository" id="id3">Cloning the Mercurial Repository</a></li>
<li><a class="reference internal" href="#selecting-a-version-of-the-code" id="id4">Selecting a version of the code</a></li>
<li><a class="reference internal" href="#updating-from-the-mercurial-repository" id="id5">Updating from the Mercurial Repository</a></li>
<li><a class="reference internal" href="#mercurial-software" id="id6">Mercurial Software</a></li>
<li><a class="reference internal" href="#mercurial-for-graphicsmagick-developers" id="id7">Mercurial for GraphicsMagick Developers</a></li>
<li><a class="reference internal" href="#ssh-public-keys-for-hg-graphicsmagick-org" id="id8">SSH Public Keys For hg.GraphicsMagick.org</a></li>
<li><a class="reference internal" href="#email-notifications" id="id9">Email Notifications</a></li>
<li><a class="reference internal" href="#rsync-the-repository" id="id10">Rsync The Repository</a></li>
<li><a class="reference internal" href="#mercurial-topics" id="id11">Mercurial Topics</a></li>
</ul>
</div>
<p>The GraphicsMagick source code is now available via <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a>.
Previously GraphicsMagick source control was via CVS, but now the
repository has been migrated to <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a>. <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> is a
convenient way for developers from around the country or world to
download the GraphicsMagick source, fix bugs, or add new features.
Due to the way <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> works, it may also be used to manage local
changes to GraphicsMagick.</p>
<div class="section" id="what-is-mercurial">
<h1><a class="toc-backref" href="#id1">What is Mercurial?</a></h1>
<p><a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> (also known as <cite>Hg</cite> due to the abbreviation for Mercury in
the periodic table of the elements) is a modern source control system
which provides anyone who clones a repository with a stand-alone local
repository containing the full development history and the ability to
select any version of the code. Since the local repository is
fully-functional, you may use the same repository to manage your local
changes to GraphicsMagick code and you may use the repository to share
your changes with others.</p>
</div>
<div class="section" id="web-access">
<h1><a class="toc-backref" href="#id2">Web Access</a></h1>
<p>The <a class="reference external" href="http://hg.code.sf.net/p/graphicsmagick/code/">GraphicsMagick repository at SourceForge</a> web interface is
available which may be used to interactively view the latest versions
of files, or the changes to files, using your web browser.</p>
</div>
<div class="section" id="cloning-the-mercurial-repository">
<h1><a class="toc-backref" href="#id3">Cloning the Mercurial Repository</a></h1>
<p>To get the tree and place it in a sub-directory of your current working
directory, issue the command:</p>
<pre class="literal-block">
hg clone http://hg.code.sf.net/p/graphicsmagick/code GM
</pre>
</div>
<div class="section" id="selecting-a-version-of-the-code">
<h1><a class="toc-backref" href="#id4">Selecting a version of the code</a></h1>
<p>By default the cloned directory is populated with files from the
<cite>default</cite> (i.e. head) branch of the code.</p>
<p>If you require a specific release of GraphicsMagick (e.g. 1.3.23), you may select it like:</p>
<pre class="literal-block">
hg update -r GraphicsMagick-1_3_23
</pre>
<p>or if you require a specific branch of GraphicsMagick (e.g. 1.3), you may use:</p>
<pre class="literal-block">
hg update -r GraphicsMagick-1_3
</pre>
<p>or you may request the files which were current on a specific date:</p>
<pre class="literal-block">
hg update -d 2009-01-14
</pre>
<p>Use:</p>
<pre class="literal-block">
hg branches
</pre>
<p>to see the available branches, and:</p>
<pre class="literal-block">
hg tags
</pre>
<p>to see the available release tags.</p>
</div>
<div class="section" id="updating-from-the-mercurial-repository">
<h1><a class="toc-backref" href="#id5">Updating from the Mercurial Repository</a></h1>
<p>To pull more changes from the repository, execute:</p>
<pre class="literal-block">
hg pull
</pre>
<p>and to make them visible in your files (via a merge), execute:</p>
<pre class="literal-block">
hg update
</pre>
<p>or just:</p>
<pre class="literal-block">
hg pull -u
</pre>
<p>The latter pulls down any updates into your local repository and
automatically does a merge.</p>
</div>
<div class="section" id="mercurial-software">
<h1><a class="toc-backref" href="#id6">Mercurial Software</a></h1>
<p>The best place to look for the latest version of Mercurial (<cite>Hg</cite>) is
at the <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> web site. Most free operating systems (e.g. Linux,
OpenSolaris, and *BSD) will offer a version of Mercurial as an
installable package and it may already be installed on your system.
We recommend use of <a class="reference external" href="https://tortoisehg.bitbucket.io/">TortoiseHg</a> on Microsoft Windows systems since it
provides a very nice graphical interface. <a class="reference external" href="https://tortoisehg.bitbucket.io/">TortoiseHg</a> is also
available on Linux and other systems.</p>
</div>
<div class="section" id="mercurial-for-graphicsmagick-developers">
<h1><a class="toc-backref" href="#id7">Mercurial for GraphicsMagick Developers</a></h1>
<p>Since <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> is a distributed revision control system, you may
clone the GraphicsMagick repository and work for days or weeks (making
your own local commits) before you decide to push some or all of your
changes to the GraphicsMagick development repository. GraphicsMagick
developers first commit changes to their own local respository, then
they push their changes to the GraphicsMagick development repository
at hg.graphicsmagick.org, later on (after testing and possible fixes)
I will push the changes to the stable repository at SourceForge.
Pushes to the stable repository at SourceForge should occur at least
as often as source code snapshots are produced.</p>
<p>The repository hierarchy is as follows:</p>
<ol class="arabic simple">
<li>Local</li>
</ol>
<blockquote>
The developer makes any local changes and commits what he likes in his
own repository. It is best to commit often and whenever all the
files have been updated to implement a coherent change or feature
(including the ChangeLog file!) since <a class="reference external" href="https://www.mercurial-scm.org/">Mercurial</a> stores related
changes as a changeset along with the change message you enter.
When you push your repository, these changesets and messages are
preserved.</blockquote>
<ol class="arabic simple" start="2">
<li>Unstable</li>
</ol>
<blockquote>
<p>The unstable development repository is available via ssh at
"<a class="reference external" href="ssh://yourid@hg.GraphicsMagick.org//hg/GraphicsMagick">ssh://yourid@hg.GraphicsMagick.org//hg/GraphicsMagick</a>".</p>
<p>Where <cite>yourid</cite> is the Unix user ID on the GraphicsMagick server.
The <cite>yourid@</cite> part may left out if your client system uses the same
user ID as on the GraphicsMagick server.</p>
</blockquote>
<ol class="arabic simple" start="3">
<li>Stable</li>
</ol>
<blockquote>
The stable repository is available via http at
"<a class="reference external" href="http://hg.code.sf.net/p/graphicsmagick/code">http://hg.code.sf.net/p/graphicsmagick/code</a>". Any changes in the
unstable development repository are pushed to the stable repository
(by the developer responsible for this role) once any necessary
adjustments have been made, documentation files have been generated,
and the software test suite has passed on at least one machine.</blockquote>
<p>To build your local development repository (as quickly as possible),
you may use these steps:</p>
<ol class="arabic">
<li><p class="first">Clone the stable respository at SourceForge:</p>
<pre class="literal-block">
hg clone http://hg.code.sf.net/p/graphicsmagick/code GM
</pre>
</li>
<li><p class="first">Adjust your local repository path default to use the unstable repository.</p>
<p>Edit .hg/hgrc in your local repository so that it contains:</p>
<pre class="literal-block">
[paths]
default = ssh://yourid@hg.GraphicsMagick.org//hg/GraphicsMagick
</pre>
<p>where <cite>yourid</cite> is the Unix user ID on the GraphicsMagick server.</p>
</li>
<li><p class="first">Pull any additional pending updates from the unstable repository:</p>
<pre class="literal-block">
hg pull -u
</pre>
</li>
</ol>
<p>Please note that when ssh access is used, Mercurial uncompresses any
data and sends it in uncompressed form. Mercurial expects that
compression will be enabled in ssh when needed. One way to enable ssh
compression is to put this in your local .hgrc:</p>
<pre class="literal-block">
[ui]
ssh = ssh -C
</pre>
<p>but ssh also provides its own way to enable compression on a
site-by-site basis (e.g. via .ssh/config). For example an entry in
.ssh/config will enable use of compression:</p>
<pre class="literal-block">
Host hg.code.sf.net
Compression yes
</pre>
</div>
<div class="section" id="ssh-public-keys-for-hg-graphicsmagick-org">
<h1><a class="toc-backref" href="#id8">SSH Public Keys For hg.GraphicsMagick.org</a></h1>
<p>In December, 2015, the services provided by hg.GraphicsMagick.org
(more formally known as src.GraphicsMagick.org) where moved to a new
server (using OpenSSH 7.1.2 at the time), with new server keys.
Developers accessing this server via ssh may be notified about a ssh
key change. For reference, these are the server's ssh public keys:</p>
<p>DSS (DSA):</p>
<pre class="literal-block">
ssh-dss AAAAB3NzaC1kc3MAAACBANZAsDZ9fUWQNwUoRw8HoNl8aLLs97KmyiaA6mSPeM1NeQKrxk0PAFEXMR05CNcZHSyopUx6B8PuTWE4+4rDhFCw7J0JkfFS4uIG3bu3YCRqQrg2k4VsDw60zK9sNum5BcLEWd+qs8X7DrEff5fGmXkc8IdMXPgHTzaJWCT9YJU1AAAAFQCJaFq4/7FqHcHm5abhW5qJyH0RgQAAAIEAgv6s3gfB8p/Elf0ZcIZ5eITCpI9aZFaSLSeKHMmhYps1uMuZ9LtWjZ11cotcuOh0tlwGUixlu/5soZqX6VbnJAuyvfI+7WSUFuJmRjsbXJVCBuSPZ7YgMNuLYlLst7sZLCs5hU61jxnaR2zmkUjDWP4GWROC6AYZXlbJX1qRJ7YAAACBAMsIbVVgz/aP95yCPk1Pw0FjoL5t6C3BpxdA9aiIFBMg14ElaHh+gaXQoZfjAuafZ8pc5woYtQLLkzinCQnmvH/EqqYCe+Fu7jcsYU7oWUXG1O9ZBKI7QZkeCTaYMXIWBplgVD+tkRpH/gxn5iweNMM9e43qPB0b2JYObliqD1E9 root@src
</pre>
<p>RSA:</p>
<pre class="literal-block">
ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAQEA1IuJDYT85qz/w6+vn5hkpzM5Ju5dsMeJD9GnATj3op5dhBWyfbaJpS7yyK2Vhhz26GBUvUtO3LGm0dQvdj83P3DX3aUuzfnC3Bc9dWeARomQPtDy9MfDikD6kqjD9/Lemgvv8I4Na9vUEmYvXUpTrtawJ4S7A7IctPnvKLPGA5+qY5XzMSE0wcOSBdbeV1PAIDOXYH2hKakZwtxXlvfTv6CZphz/jG5nmf+/Zlkr4yopNvPFbtd3vbaaqSuCoGHXKfmpRko2gXf6EGF92wXzbsE1tW3AkSJ2xdhFHRNmQEu2y9F1l9zb8IETBtKMWRJWAsPPpUSkht0DRsTXt/f+Zw== root@src
</pre>
<p>ECDSA:</p>
<pre class="literal-block">
ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBOrGQ6tjmZvm8w+GP7yLFJ1/vkImKkpXv7kPNxA0+Sfx6WCqAjV0pWP5MVCraP8SNbphL8jiS/x3WADXlf+R2KQ= root@src
</pre>
<p>ED25519:</p>
<pre class="literal-block">
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIAtwIcJEBiSUWsB2sydInR76gE84Jp1rxmc8lTGPg5cB root@src
</pre>
</div>
<div class="section" id="email-notifications">
<h1><a class="toc-backref" href="#id9">Email Notifications</a></h1>
<p>An email notification is sent to the <a class="reference external" href="https://lists.sourceforge.net/lists/listinfo/graphicsmagick-commit">graphicsmagick-commit</a> mailing
list at SourceForge whenever a change is submitted to the development
(unstable) repository. Subscribe to this list if you would like to be
notified by email of changes when they occur.</p>
</div>
<div class="section" id="rsync-the-repository">
<h1><a class="toc-backref" href="#id10">Rsync The Repository</a></h1>
<p>It is possible to use the <a class="reference external" href="http://rsync.samba.org/">rsync</a> program to make a copy of the
GraphicsMagick Mercurial repository. Using <a class="reference external" href="http://rsync.samba.org/">rsync</a> might be faster for
the initial repository checkout, but the copied repository might not
be coherent if it was updated while the <a class="reference external" href="http://rsync.samba.org/">rsync</a> was in progress. If
there is any problem, just execute the same <a class="reference external" href="http://rsync.samba.org/">rsync</a> command again
without deleting any files and the remaining changes (updated files)
will be transferred. To use <a class="reference external" href="http://rsync.samba.org/">rsync</a> to copy the repository do:</p>
<pre class="literal-block">
mkdir -p GM
rsync -avPSz hg.code.sf.net::p/graphicsmagick/code/ GM/
</pre>
<p>Rsync will not checkout a working set of files. To accomplish that
do:</p>
<pre class="literal-block">
cd GM
hg update
</pre>
</div>
<div class="section" id="mercurial-topics">
<h1><a class="toc-backref" href="#id11">Mercurial Topics</a></h1>
<ul class="simple">
<li><a class="reference external" href="https://www.mercurial-scm.org/wiki/MergeToolConfiguration">Merge Tool Configuration</a></li>
<li><a class="reference external" href="https://www.mercurial-scm.org/wiki/TipsAndTricks#Keep_.22My.22_or_.22Their.22_files_when_doing_a_merge">Keep "My" or "Their" files when doing a merge</a></li>
</ul>
<hr class="docutils" />
<p>Copyright © GraphicsMagick Group 2012 - 2018</p>
</div>
</div>
</body>
</html>
|