[darcs-users] darcs patch: Refactor Darcs homepage. (and one more).

Eric Kow kowey at darcs.net
Sat Apr 11 09:00:18 UTC 2009


On Sat, Apr 11, 2009 at 17:08:04 +1000, Trent W.Buck wrote:
> PS: Eric, even if the layout changes are rejected, I'd like to keep
> the text changes.  IMO the old text reflects more the status of Darcs
> 1 back in 2006 rather than where we (and our competition) are at now.

Ahah, time for me to wheel out the Marketing Team.  Max, Guillaume and
others, what do you think?

> Sat Apr 11 14:27:36 EST 2009  Trent W. Buck <trentbuck at gmail.com>
>   * Follow autoconf convention of @VAR@ for .in files.

I'll apply this one.
 
> Sat Apr 11 16:55:31 EST 2009  Trent W. Buck <trentbuck at gmail.com>
>   * Refactor Darcs homepage.
>   As well as rewriting and updating the text and layout, I have taken
>   the opportunity to convert this to strict XHTML (from HTML 4).

Follow autoconf convention of @VAR@ for .in files.
--------------------------------------------------
> Trent W. Buck <trentbuck at gmail.com>**20090411042736
>  Ignore-this: 2301bde8b0f45669093cb882f3e3bf76
> ] hunk ./doc/index.html.in 76
>  
>            <p>While using a binary from above is recommend, here is the latest source code for those who want it.</p>
>            <ul>
> -            <li><a href="darcs-VERSION.tar.gz">Latest Prerelease Source</a> (VERSION).  <br/></li>
> -            <li><a href="darcs-RELEASE.tar.gz">Latest Stable Source</a> (RELEASE).  <br/></li>
> +            <li><a href="darcs- at VERSION@.tar.gz">Latest Prerelease Source</a> (@VERSION@).  <br/></li>
> +            <li><a href="darcs- at RELEASE@.tar.gz">Latest Stable Source</a> (@RELEASE@).  <br/></li>
>            </ul>
>  
>            <h3>Documentation</h3>
> hunk ./release/determine_release_state.pl 52
>  
>  if (open(FIN,"doc/index.html.in") && open(FOUT,">doc/index.html")) {
>    while (<FIN>) {
> -    s/VERSION/$official_version/g;
> -    s/RELEASE/$lastrelease/g;
> +    s/\@VERSION\@/$official_version/g;
> +    s/\@RELEASE\@/$lastrelease/g;
>      print FOUT $_;
>    }
>    close(FIN);

Refactor Darcs homepage.
------------------------
> Trent W. Buck <trentbuck at gmail.com>**20090411065531
>  Ignore-this: 25ae980384aae31487aea3343373a0a2
>  As well as rewriting and updating the text and layout, I have taken
>  the opportunity to convert this to strict XHTML (from HTML 4).
> ] hunk ./doc/index.html.in 1
> -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
> -<html lang="en">
> +<?xml version="1.0" encoding="utf-8"?>
> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
> +  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
>    <head>
> hunk ./doc/index.html.in 6
> -    <title>darcs</title>
> -    <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
> -    <meta name="description" content="darcs is an advanced revision control system.">
> -    <meta name="keywords" content="darcs scm subversion alternative CVS free software gpl linux debian">
> -    <link rel="stylesheet" type="text/css" href="darcs.css">
> +    <title>Darcs</title>
> +    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
> +    <meta name="description" content="Darcs home page." />
> +    <meta name="keywords" content="Darcs distributed version control VCS RCS SCM" />
> +    <link rel="stylesheet" type="text/css" href="darcs.css" />
>    </head>
>  
>    <body>
> hunk ./doc/index.html.in 14
> +    <h1>
> +      <img src="http://www.darcs.net/logos/logo.png" width="242" height="79" alt="Darcs" />
> +    </h1>
>  
> hunk ./doc/index.html.in 18
> -    <div align="center">
> -      <img src="http://www.darcs.net/logos/logo.png" border="0" width="242" height="79" alt=""><br>
> -      <strong>Distributed. Interactive. Smart.</strong>
> -    </div>
> +    <blockquote>
> +      <p><q>Project leaders should certainly consider its adoption.</q></p>
> +      <p>&mdash;<a href="http://lwn.net/Articles/109719/">Linux Weekly News</a>, 2004</p>
> +    </blockquote>
>  
> hunk ./doc/index.html.in 23
> -    <table align="center">
> -      <tr>
> -        <td width="150" valign="top">
> -          <p>&nbsp;</p>
> -          <p>&nbsp;</p>
> -          <p>&nbsp;</p>
> -          <div style="font-size:smaller; background-color:#CCCCFF; padding: 4px; ">
> -            <i>"Project leaders should certainly consider its adoption." <br>
> -            &mdash;<a href="http://lwn.net/Articles/109719/">Linux Weekly News</a></i>
> -          </div>
> +    <p>Darcs is a free, distributed version control system with an
> +    emphasis on innovation and ease of use.</p>
>  
> hunk ./doc/index.html.in 26
> +    <dl>
> +      <dt>Free</dt>
> +      <dd>Darcs is licensed under the GPL, which means that you are
> +      free to use, study, redistribute and improve Darcs, and always
> +      will be.</dd>
>  
> hunk ./doc/index.html.in 32
> -        </td>
> -        <td width="15"></td>
> -        <td width="500">
> +      <dt>Distributed</dt>
> +      <dd>Users have full power over their local repositories even
> +      when offline, and can exchange contributions directly, without
> +      the need for a central server.</dd>
>  
> hunk ./doc/index.html.in 37
> -          <p><a name="intro">Darcs is a free, open source source code management system.</a> </p>
> +      <dt>Innovative</dt>
> +      <dd>Darcs was one of the first implementations of distributed
> +      version control.  Unlike younger projects, Darcs' design is
> +      grounded solidly in <q>patch theory</q>, and continues to
> +      improve as our understanding grows.  This has concrete benefits
> +      for users in terms of exceptional flexibility when manipulating
> +      patches.</dd>
>  
> hunk ./doc/index.html.in 45
> -          <h2>Distributed</h2>
> +      <dt>Easy to use</dt>
> +      <dd>Darcs is interactive, and it will ask you questions instead
> +      of making assumptions about what you want to do.  This makes it
> +      easy to choose which changes you want to record, or which
> +      updates you want to download.  Darcs is based on mathematical
> +      theory, but you don't need to understand it to get started!</dd>
> +    </dl>
>  
> hunk ./doc/index.html.in 53
> -          <p>Every user has access to the full command set, removing 
> -          boundaries between server and client or committer and non-committers.</p>
> +    <p>Darcs may have been a research project when it was founded in
> +    2002, but it is now a mature, production-ready tool with a growing
> +    community of users and developers.  We think that Darcs has things
> +    to offer that younger rivals like git and hg still can't
> +    match.</p>
>  
> hunk ./doc/index.html.in 59
> -          <h2>Interactive</h2>
> +    <h1>User Resources</h1>
> +    <ul>
> +      <li>Pre-built <a
> +      href="http://wiki.darcs.net/DarcsWiki/Binaries">Darcs
> +      binaries</a> are available for Windows and many Unix-like
> +      platforms.</li>
> +      <li>The Darcs <a href="manual">user manual</a> and <a
> +      href="http://wiki.darcs.net/DarcsWiki">wiki</a>.</li>
> +      <li>The <a
> +      href="http://lists.osuosl.org/mailman/listinfo/darcs-users">darcs-users
> +      mailing list</a>, now also used for developer discussion.</li>
> +    </ul>
>  
> hunk ./doc/index.html.in 72
> -          <p>Darcs is easy to learn and efficient to use because it asks
> -          you questions in response to simple commands, giving you choices
> -          in your work flow. You can choose to record
> -          one change in a file, while ignoring another. As you update
> -          from upstream, you can review each patch name, even the full "diff"
> -          for interesting patches.  </p>
> -
> -          <h2>Smart</h2>
> -
> -          <p>Originally developed by physicist David Roundy, darcs is
> -          based on a unique algebra of patches. </p>
> -
> -          <p>This smartness lets you respond to changing demands 
> -          in ways that would otherwise not be possible. For example, learn
> -          about <a href="http://wiki.darcs.net/DarcsWiki/SpontaneousBranches">spontaneous branches</a> with darcs.</p>
> -
> -          <h2>Going Places</h2>
> -          <p>First released in 2003, Darcs is now managed by a sizable
> -          team of programmers. Daily improvements,
> -          combined with tight quality control, culminate in frequent
> -          releases.</p>
> -
> -          <hr>
> -
> -
> -
> -          <h3>Download</h3>
> -
> -          <p>
> -          <a href="http://wiki.darcs.net/DarcsWiki/Binaries">Binaries and source of the latest stable release</a> of darcs for various platforms including Windows, Mac OS X, FreeBSD and its siblings, Solaris, and AIX, a dozen flavors of Linux, and Cygwin.</p>
> -
> -          <p>While using a binary from above is recommend, here is the latest source code for those who want it.</p>
> -          <ul>
> -            <li><a href="darcs- at VERSION@.tar.gz">Latest Prerelease Source</a> (@VERSION@).  <br/></li>
> -            <li><a href="darcs- at RELEASE@.tar.gz">Latest Stable Source</a> (@RELEASE@).  <br/></li>
> -          </ul>
> -
> -          <h3>Documentation</h3>
> -
> -          <ul>
> -            <li><a href="manual">darcs manual</a> <br></li>
> -            <li><a href="api-doc/">darcs API docs</a> <br></li>
> -          </ul>
> -
> -          <h3>Community</h3>
> -
> -          <ul>
> -            <li><strong><a href="http://wiki.darcs.net/DarcsWiki">The Darcs Wiki</a></strong> -- The best source for further information.</li>
> -            <li><a href="http://lists.osuosl.org/mailman/listinfo/darcs-users">users mailing list</a> </li>
> -            <li><a href="http://lists.osuosl.org/mailman/listinfo/darcs-devel">developers mailing list</a> </li>
> -            <li><a href="http://bugs.darcs.net/?user=guest;pass=guest">Bug Tracking System</a> </li>
> -            <li><a href="http://allmydata.org/trac/darcs-2/browser">Darcs repository browser</a></li>
> -          </ul>
> -
> -          <h3>Darcs source repository</h3>
> -          <ul>
> -            <li>darcs get --lazy http://darcs.net</li>
> -          </ul>
> -          <p>Note, to get the Darcs source you must already have Darcs version 2 or greater (Darcs 1 will give an obscure error). If necessary, download a binary or build the source tarball to get a working Darcs 2.</p>
> -
> -        </td>
> -        <td width="150"></td> 
> -    </tr></table>
> +    <h1>Developer Resources</h1>
> +    <ul>
> +      <li><a href="darcs- at VERSION@.tar.gz">Latest Prerelease
> +      Source</a> (@VERSION@).</li>
> +      <li><a href="darcs- at RELEASE@.tar.gz">Latest Stable Source</a>
> +      (@RELEASE@).</li>
> +      <li>The <a href="api-doc/">API documentation</a> (haddock).</li>
> +      <li>The <a
> +      href="http://lists.osuosl.org/mailman/listinfo/darcs-devel">darcs-devel
> +      mailing list</a>, now only used for automatic commit
> +      messages.</li>
> +      <li>The <a
> +      href="http://bugs.darcs.net/?user=guest;pass=guest">bug
> +      tracker</a> (roundup).</li>
> +      <li><a href="http://allmydata.org/trac/darcs-2/browser">Darcs
> +      repository browser</a>.</li>
> +    </ul>
>  
> hunk ./doc/index.html.in 90
> +    <p>You can get a copy of the development tree by running
> +    <code>darcs get --lazy http://darcs.net</code>.  This requires
> +    Darcs 2.0.0 or higher.</p>
>    </body>
>  </html>
> 

-- 
Eric Kow <http://www.nltg.brighton.ac.uk/home/Eric.Kow>
PGP Key ID: 08AC04F9
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 194 bytes
Desc: not available
URL: <http://lists.osuosl.org/pipermail/darcs-users/attachments/20090411/c9a31aaa/attachment-0001.pgp>


More information about the darcs-users mailing list