[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Making revision graphs easier to read

From: Stefan Küng <tortoisesvn_at_gmail.com>
Date: Wed, 03 Sep 2008 21:25:04 +0200

Simon Large wrote:
> 2008/9/2 Glenn <oznelg_at_yahoo.com>:
>> I've just started to use TortoiseSVN so even though the revision
>> graphs are relatively new and users must have been struggling without
>> them for a long time, from my point of view they are and always
>> have been part of TortoiseSVN. As such they are very helpful and
>> could use a few tweaks to make them even more helpful.
>>
>> 1. The manual needs _pictures_ of each of the types of revision
>> graph nodes. Verbal descriptions are ok but a picture is worth...
>
> OK, I'll see what I can do.
>
>> 2. It seems that there are various combinations of icons and node
>> shapes. The pictures in the icons don't seem to be mentioned at
>> all in the documentation. For example, one of these
>> icons shows a pencil. What does
>> it indicate? Searching for "pencil" in the manual brings no hits.
>> Again, showing all the combinations of shapes & icons
>> or two separate sections: one
>> showing shapes with descriptions, and another showing icons with
>> descriptions might do the job. The "Icon Overlays" dictionary in the
>> documentation is a good example of this kind of thing.
>
> I may need some help with the descriptions on this one. Stefan^2?

The pencil icon means the node was renamed.

green arrow : last commit
pencil : renamed
two papers connected with a green arrow : replaced and also "tag" (I
guess we have to get someone to draw better icons :)
the other icons should be obvious.

the shapes are as follows:
octangle: deleted, replaced, renamed
rounded rect: added, added with history (i.e., a copy)
ellipse : last commit on that branch/tag/trunk
rectangle : all other (normal) nodes

>> 3. Furthermore each node has a color. What do the colors mean?
>> Ok, while researching something else I just stumbled on the answer
>> in the Settings -> Color screen. I suggest the documentation for
>> this screen have two subsections titled, "Status and Action Colors"
>> and "Revision Graph Node Colors." That way searching for "Revision
>> Graph" will bring up this section (currently the only reference to
>> "revision graph" is in the screenshot which is, of-course, not
>> searchable. I also suggest adding a sentence to the "Revision
>> Graph Nodes" section that says you can look up and control the
>> colors for different types of nodes using the Settings -> Colors
>> screen.
>
> Good point.
>
>> 4. Maybe some text could be added to the box that appears when you
>> roll the mouse over each revision graph node. It could
>> say something like Tip Node, added/deleted/renamed node, initial branch node, etc.
>
> One for Stefan/Stefan^2

Is that really necessary? The action/operation is shown in the urls (and
the copyfrom url).

Stefan

-- 
       ___
  oo  // \\      "De Chelonian Mobile"
 (_,\/ \_/ \     TortoiseSVN
   \ \_/_\_/>    The coolest Interface to (Sub)Version Control
   /_/   \_\     http://tortoisesvn.net

Received on 2008-09-03 21:25:22 CEST

This is an archived mail posted to the TortoiseSVN Users mailing list.