<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
<TITLE>GraphicsMagick Source Access Using CVS</TITLE>
<META NAME="GENERATOR" CONTENT="StarOffice 8 (Solaris x86)">
<META NAME="CREATED" CONTENT="20020908;16044300">
<META NAME="CHANGEDBY" CONTENT="Bob Friesenhahn">
<META NAME="CHANGED" CONTENT="20080725;17380300">
<META NAME="DESCRIPTION" 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.">
<META NAME="KEYWORDS" CONTENT="GraphicsMagick, Image Magick, Image Magic, PerlMagick, Perl Magick, Perl Magic, CineMagick, PixelMagick, Pixel Magic, WebMagick, Web Magic, visualization, image processing, software development, simulation, image, software, AniMagick, Animagic, Magick++">
<META NAME="CHANGEDBY" CONTENT="Bob Friesenhahn">
<META NAME="CHANGEDBY" CONTENT="Bob Friesenhahn">
<META NAME="CHANGEDBY" CONTENT="Bob Friesenhahn">
<STYLE TYPE="text/css">
<!--
@page { size: 8.5in 11in }
TD P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
P { color: #000000; font-family: "Verdana", "Arial", "Helvetica", sans-serif; font-size: 12pt }
PRE { color: #000000 }
A:link { color: #0085c0 }
A:visited { color: #800080 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-US" TEXT="#000000" LINK="#0085c0" VLINK="#800080" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=0 STYLE="page-break-before: always">
<COL WIDTH=256*>
<TR>
<TD WIDTH=100% BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic1" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><FONT COLOR="#ffffff"><FONT FACE="Helvetica, Arial"><B>GraphicsMagick
CVS</B></FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P><FONT SIZE=3>The GraphicsMagick source is available via anonymous
CVS. This is a convenient way for developers from around the country
or world to download the GraphicsMagick source, fix bugs, or add new
features. </FONT>
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic2" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><FONT COLOR="#ffffff"><FONT FACE="Helvetica, Arial"><B>What
is CVS</B></FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P STYLE="margin-bottom: 0in"><FONT SIZE=3>CVS is the Concurrent
Version System and is a very popular mean of version control for
software projects. It is designed to allow multiple authors to be
able to simultaneously operate on the same source tree. This source
tree is centrally maintained, but each developer has a local mirror
of this repository that they make their changes to. </FONT>
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=0>
<COL WIDTH=256*>
<TR>
<TD WIDTH=100% BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic11" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><FONT COLOR="#ffffff"><FONT FACE="Helvetica, Arial"><B>CVSWeb
Access</B></FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P STYLE="margin-bottom: 0in">A <A HREF="http://cvs.graphicsmagick.org/cgi-bin/cvsweb.cgi/">CVSWeb</A>
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>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic3" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><FONT COLOR="#ffffff"><FONT FACE="Helvetica, Arial"><B>CVS
Command Summary</B></FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P STYLE="margin-bottom: 0in">Here is a summary of CVS commands. See
the <A HREF="http://www.cvshome.org/" TARGET="_top">CVS Home Page</A>
for detailed information and documentation about CVS. The command
"cvs –help-commands" will print out all of the
available commands. The command "cvs <I>command</I> –help"
will cause a help message to be printed for the specified "<I>command</I>".</P>
<CENTER>
<TABLE WIDTH=96% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0 BGCOLOR="#99ccff">
<COL WIDTH=30*>
<COL WIDTH=226*>
<TR>
<TD WIDTH=12% BGCOLOR="#52799e">
<P ALIGN=CENTER STYLE="font-style: normal; text-decoration: none">
<FONT COLOR="#ffffff"><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3><B><SPAN STYLE="background: transparent">Action</SPAN></B></FONT></FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#52799e">
<P ALIGN=CENTER STYLE="font-style: normal; text-decoration: none">
<FONT COLOR="#ffffff"><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3><B><SPAN STYLE="background: transparent">Result</SPAN></B></FONT></FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>add</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Add
a new file or directory to the repository.</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>checkout</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Make
a working directory of source files for editing.</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>commit</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Apply
changes to the source repository (write access).</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>diff</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Show
differences between local files and the source repository.</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>history</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Show
reports on cvs commands against the source repository.</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>log</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Display
CVS log information.</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>rdiff</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Prepare
a collection of differences reflecting changes between release.</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>status</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Show
current status of files in the repository and local copies.</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>update</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>Bring
your working directory up to date with the repository.</FONT></FONT></P>
</TD>
</TR>
</TABLE>
</CENTER>
<P STYLE="margin-bottom: 0in"><BR>
</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic4" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><FONT COLOR="#ffffff"><FONT FACE="Helvetica, Arial"><B>Using
Anonymous CVS</B></FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P>A live source tree for GraphicsMagick is available from
<TT>cvs.graphicsmagick.org</TT>. This source tree may be retrieved
over the network using the <A HREF="http://www.cvshome.org/" TARGET="_top">CVS
program</A>. Microsoft Windows users may be interested in
<A HREF="http://www.tortoisecvs.org/" TARGET="_top">TortoiseCVS</A>,
which transparently extends the Windows file manager to support CVS.
There are currently two CVS protocols available for use: 'EXT' and
'PSERVER'. The 'EXT' protocol is used on top of encrypted SSH so it
is very secure. The 'PSERVER' protocol uses simple TCP and plain-text
passwords so it is not very secure. GraphicsMagick CVS is in the
process of transitioning to using SSH access only (due to security
concerns), so using the EXT protocol is recommended. Some corporate
firewalls do not allow outbound PSERVER connections (to TCP port
2401) while they do allow SSH connections.</P>
<P>The protocol to use is indicated by the prefix of the CVSROOT
specification. The CVSROOT specification may be specified via the
CVSROOT environment variable or as an argument to the cvs -d option.
The necessary CVSROOT specifications are shown in the following
table.</P>
<CENTER>
<TABLE WIDTH=96% BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0 BGCOLOR="#99ccff">
<COL WIDTH=30*>
<COL WIDTH=226*>
<TR>
<TD WIDTH=12% BGCOLOR="#52799e">
<P ALIGN=CENTER STYLE="font-style: normal; text-decoration: none">
<FONT COLOR="#ffffff"><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3><B><SPAN STYLE="background: transparent">Protocol</SPAN></B></FONT></FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#52799e">
<P ALIGN=CENTER STYLE="font-style: normal; text-decoration: none">
<FONT COLOR="#ffffff"><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3><B><SPAN STYLE="background: transparent">CVSROOT
Specification</SPAN></B></FONT></FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>EXT</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<PRE STYLE="font-style: normal; font-weight: medium; text-align: left; text-decoration: none"><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>:ext:anoncvs@cvs.graphicsmagick.org:/GraphicsMagick</FONT></FONT></PRE>
</TD>
</TR>
<TR>
<TD WIDTH=12% BGCOLOR="#ffffff">
<P ALIGN=LEFT STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>PSERVER</FONT></FONT></P>
</TD>
<TD WIDTH=88% BGCOLOR="#ffffff">
<PRE STYLE="font-style: normal; font-weight: medium; text-align: left; text-decoration: none"><FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>:pserver:anonymous@cvs.graphicsmagick.org:/GraphicsMagick</FONT></FONT></PRE>
</TD>
</TR>
</TABLE>
</CENTER>
<P STYLE="margin-bottom: 0in"><BR>
</P>
<P><FONT SIZE=3>To specify the cvs root directly on the command line:
</FONT>
</P>
<PRE STYLE="margin-bottom: 0.2in"> cvs -d :pserver:anonymous@cvs.graphicsmagick.org:/GraphicsMagick command args...</PRE><P>
<FONT SIZE=3>Or to set as an environment variable:</FONT></P>
<P><FONT SIZE=3>export
CVSROOT=<SPAN STYLE="text-decoration: none">:ext:anoncvs@cvs.graphicsmagick.org:/GraphicsMagick</SPAN></FONT></P>
<P STYLE="font-style: normal; font-weight: medium; text-decoration: none">
<FONT FACE="Verdana, Arial, Helvetica, sans-serif"><FONT SIZE=3>setenv
CVSROOT :ext:anoncvs@cvs.graphicsmagick.org:/GraphicsMagick</FONT></FONT></P>
<P><FONT SIZE=3>When using the PSERVER protocol, a CVS login is
needed prior to checking out the sources:</FONT></P>
<PRE STYLE="margin-bottom: 0.2in"> cvs login</PRE><P>
<FONT SIZE=3>This will ask you for a password. The password is
<I>anonymous</I>. Enter it and press Return. The EXT protocol does
not currently require a password when used for anonymous access.</FONT></P>
<P><FONT SIZE=3>The CVS program supports a configuration file
($HOME/.cvsrc). Many command options used in the remaining
instructions may be set as defaults (so they don't need to be
repeated) by creating a .cvsrc file in your home directory with the
following contents:</FONT></P>
<PRE>cvs -z3
update -P -d
checkout -P
diff -u</PRE><P>
<FONT SIZE=3>To get the tree and place it in a sub-directory of your
current working directory, issue the command: </FONT>
</P>
<PRE STYLE="margin-bottom: 0.2in"> cvs co -P GraphicsMagick</PRE><P>
<FONT SIZE=3>Or to save bandwidth get the compressed version, type: </FONT>
</P>
<PRE STYLE="margin-bottom: 0.2in"> cvs -z3 co -P GraphicsMagick</PRE><P>
<FONT SIZE=3>Note that adding "<FONT FACE="Courier New">-r
GraphicsMagick-1_2</FONT>" requests the sources from the
GraphicsMagick 1.2 release branch.</FONT></P>
<P><FONT SIZE=3>To update the sources within a checked out directory
execute </FONT>
</P>
<PRE STYLE="margin-bottom: 0.2in"> cvs update -P -d</PRE><P>
<FONT SIZE=3>and only the files which have changed will be updated. </FONT>
</P>
<P><FONT SIZE=3>The available modules relating to GraphicsMagick are:
</FONT>
</P>
<DL>
<DD>
<TABLE WIDTH=90% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<COL WIDTH=5*>
<COL WIDTH=84*>
<COL WIDTH=167*>
<TR VALIGN=TOP>
<TD WIDTH=2%>
<P><IMG SRC="../images/ball.png" NAME="Graphic5" ALT="*" ALIGN=BOTTOM WIDTH=14 HEIGHT=14 BORDER=0></P>
</TD>
<TD WIDTH=33%>
<P><FONT SIZE=3>GraphicsMagick</FONT></P>
</TD>
<TD WIDTH=65%>
<P><FONT SIZE=3>(core sources)</FONT></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=2%>
<P><IMG SRC="../images/ball.png" NAME="Graphic6" ALT="*" ALIGN=BOTTOM WIDTH=14 HEIGHT=14 BORDER=0></P>
</TD>
<TD WIDTH=33%>
<P><FONT SIZE=3>GraphicsMagick-NT</FONT></P>
</TD>
<TD WIDTH=65%>
<P><FONT SIZE=3>(everything needed for Microsoft Windows)</FONT></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=2%>
<P><IMG SRC="../images/ball.png" NAME="Graphic7" ALT="*" ALIGN=BOTTOM WIDTH=14 HEIGHT=14 BORDER=0></P>
</TD>
<TD WIDTH=33%>
<P><FONT SIZE=3>GraphicsMagick-World</FONT></P>
</TD>
<TD WIDTH=65%>
<P><FONT SIZE=3>(<U>everything</U> related to GraphicsMagick)</FONT></P>
</TD>
</TR>
</TABLE>
</DL>
<P><FONT SIZE=3>To check out the GraphicsMagick source for Microsoft
Windows, try this command line: </FONT>
</P>
<PRE STYLE="margin-bottom: 0.2in"> cvs -z3 co -P -r GraphicsMagick-1_2 GraphicsMagick-NT</PRE><P>
<FONT SIZE=3>If you require a specific release of GraphicsMagick
(e.g. 1.2.4), you may check it out like</FONT></P>
<PRE STYLE="margin-bottom: 0.2in"> cvs -z3 co-r GraphicsMagick-1_2_5 -P GraphicsMagick</PRE><P>
<FONT SIZE=3>where the "<FONT FACE="Cumberland">GraphicsMagick-1_2_5</FONT>"
is the release tag. You can use</FONT></P>
<PRE STYLE="margin-bottom: 0.2in"> cvs status -v README.txt</PRE><P>
<FONT SIZE=3>from within an existing checked out directory to see
what branch and release tags are available.</FONT></P>
<P><FONT SIZE=3>You can use</FONT></P>
<PRE STYLE="margin-bottom: 0.2in"> cvs -z3 update -r GraphicsMagick-1_2_5</PRE><P>
<FONT SIZE=3>from within an existing checked out directory to move it
up (or down) to that branch or release tag.</FONT></P>
<P><FONT SIZE=3>Checking out from release tag, or updating to a
release tag, causes the "sticky" flag to be set on checked
out files so that further update requests will only cause an update
if the tag is a branch tag, and is a newer version on the branch. To
clear the sticky flags and update to the most current version on the
trunk, use</FONT></P>
<PRE STYLE="margin-bottom: 0.2in"> cvs -z3 update -A</PRE><P>
<FONT SIZE=3>Once a release has been tagged, checking out or updating
using a release tag is the only reliable way to obtain release files
from CVS since the default is to check out the most current sources
on the requested branch, which may not be stable or released.</FONT></P>
<P>Using compression levels over <TT>-z3</TT>,may slow the CVS
transfer since they require the CVS server to work much harder, yet
don't compress the data much more.</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=2 CELLSPACING=2>
<TR>
<TD BGCOLOR="#52799e">
<P ALIGN=LEFT><IMG SRC="../images/right_triangle.png" NAME="Graphic8" ALT=">" ALIGN=BOTTOM WIDTH=15 HEIGHT=14 BORDER=0><FONT COLOR="#ffffff"><FONT FACE="Helvetica, Arial"><B>CVS
Software</B></FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P STYLE="margin-bottom: 0in">The best place to look for the latest
version of CVS is at the <A HREF="http://www.cvshome.org/" TARGET="_top">CVS
Home Page </A>. There is also a lot of information and documentation
about CVS available.
</P>
<HR>
<P ALIGN=CENTER><A HREF="Copyright.html">Copyright</A> <FONT FACE="Abadi Mt Condensed Extra Bold">©</FONT>
GraphicsMagick Group 2002 - 2008</P>
</BODY>
</HTML>
