← Back to branch summary

~ubuntu-branches/ubuntu/quantal/netbeans/quantal

« back to all changes in this revision

Viewing changes to versioncontrol/mercurial/javahelp/org/netbeans/modules/mercurial/docs/mercurial-status.html

  • Committer: Bazaar Package Importer
  • Author(s): Marek Slama
  • Date: 2008-01-29 14:11:22 UTC
  • Revision ID: james.westby@ubuntu.com-20080129141122-fnzjbo11ntghxfu7
Tags: upstream-6.0.1
Import upstream version 6.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
versioncontrol/mercurial/javahelp/org/netbeans/modules/mercurial/docs/mercurial-status.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 
2
            "http://www.w3.org/TR/html4/loose.dtd">
 
3
<!--
 
4
*     Copyright © 2007 Sun Microsystems, Inc. All rights reserved.
 
5
*     Use is subject to license terms.
 
6
-->
 
7
<html>
 
8
    <head>
 
9
        <title>Viewing File Status Information</title>
 
10
        <meta http-equiv="Content-Type" content="text/html;charset=utf-8" >
 
11
        <link href="nbdocs://org.netbeans.modules.usersguide/org/netbeans/modules/usersguide/ide.css"
 
12
            rel="StyleSheet" type="text/css">
 
13
    </head>
 
14
    
 
15
    <body>
 
16
        <h2>Viewing File Status Information</h2>
 
17
        
 
18
        <p><small><a href="#seealso">See Also</a></small></p>
 
19
        
 
20
        <p>The IDE's Mercurial support enables you to view and manage the evolution
 
21
        of changes in version-controlled files.</p>
 
22
        
 
23
        <h3>Viewing Revision Information<a name="viewing"></a></h3>
 
24
        
 
25
        <p>The IDE's Mercurial support enables you to view version status information in 
 
26
            many of the IDE's windows, including the Status, 
 
27
            Projects, Files, and Favorites windows. The <a href="mercurial-statuswindow.html">Status Window</a>, however, represents 
 
28
            the primary place within which to manage version-controlled files by displaying a 
 
29
            list of all of the new, modified, and removed files in the currently selected project 
 
30
            or directory.</p>
 
31
        
 
32
        <h4>To open the Status window, choose either:</h4>
 
33
        
 
34
        <ul>
 
35
            <li>Mercurial &gt; Status from the right-click menu of a version-controlled 
 
36
                file or folder from the Projects, Files, or Favorites window.</li>
 
37
            <li>Versioning &gt; Status from the main menu.</li>
 
38
            <li>Choose Window &gt; Versioning &gt; Mercurial from the main menu.</li>                
 
39
        </ul>
 
40
        
 
41
        <h4>The IDE's Mercurial support provides file status information in the following ways:</h4>
 
42
        
 
43
        <ul>
 
44
            <li><strong>Status Labels</strong>. Textual indication of file status in the Status, 
 
45
                Projects, Files, and Favorites windows. To display status labels, choose View 
 
46
                &gt; Show Versioning Labels from the main menu.</li>
 
47
            <li><strong>Status Color</strong>. Graphical indication of file status in the Status, 
 
48
                Projects, Files, and Favorites windows.</li>
 
49
            <li><strong>Status Badges</strong>. Graphical indication of the status of files contained 
 
50
                within your project, folder, and package nodes. Displayed in the Projects, Files, 
 
51
                and Favorites windows.</li>
 
52
            <li><strong>Revision Annotations</strong>. Displays commit message, author, date, and 
 
53
                revision number information in the left margin of files open in the Source Editor. 
 
54
                To display annotations, select a versioned file and choose Show Annotations (or 
 
55
                Mercurial &gt; Show Annotations) from its right-click menu. Alternatively, choose 
 
56
                Versioning, &gt; Show Annotations from the main menu.</li>
 
57
        </ul>
 
58
        
 
59
        <p>The IDE displays version-controlled files using the following color coding and font styles:</p>
 
60
        
 
61
        <table border="1" cellpadding="5">
 
62
            <tr>
 
63
                <th>Color Coding</th>
 
64
                <th align="center">Description</th>
 
65
            </tr>
 
66
            <tr>
 
67
                <td><img src="images/green_status.png" alt="green status"></td>
 
68
                <td><strong>Green</strong>. Indicates that the file is a new
 
69
                    local file that does not yet exist in the repository.</td>
 
70
            </tr>
 
71
            <tr>
 
72
                <td><img src="images/blue_status.png" alt="blue status"></td>
 
73
                <td><strong>Blue</strong>. Indicates that the file has been 
 
74
                    modified locally.</td>
 
75
            </tr>
 
76
            <tr>
 
77
                <td><img src="images/red_status.png" alt="red status"></td>
 
78
                <td><strong>Red</strong>. Indicates that the file contains conflicts.
 
79
                    You must employ the Resolve Conflicts command (Mercurial &gt; Resolve 
 
80
                    Conflicts) for such files.</td>
 
81
            </tr>
 
82
            <tr>
 
83
                <td><img src="images/grey_status.png" alt="grey status"></td>
 
84
                <td><strong>Grey</strong>. Indicates that the file is ignored by Mercurial 
 
85
                    and will not be included when calling versioning commands. In the
 
86
                    <a href="csh/svn_versioning_window.html">Status window</a>, grey 
 
87
                    text signifies deleted files.</td>
 
88
            </tr>                    
 
89
            <tr>
 
90
                <td><img src="images/strikethrough_status.png" alt="strike-through status"></td>
 
91
                <td><strong>Strike-through</strong>. Indicates that the file is excluded when 
 
92
                    calling the Commit command. All other Mercurial commands, however, work as 
 
93
                    usual. Note that files displayed in the strike-through style only appear in 
 
94
                    the Status window and Commit dialog. They will not appear in Diff panes, 
 
95
                    nor will their parent folders (or packages) display badges if they are modified.</td>
 
96
            </tr>
 
97
        </table>
 
98
        
 
99
        <br>
 
100
        <p>Current Mercurial file status is indicated by adding the following badges
 
101
            to project, package and directory icons:</p>
 
102
        
 
103
        <table border="1" cellpadding="5">
 
104
            <tr>
 
105
                <th>Badge</th>
 
106
                <th>Description</th>
 
107
            </tr>
 
108
            <tr>
 
109
                <td><img src="images/blue_badge.png" alt="blue badge"></td>
 
110
                <td><strong>Locally Modified Badge</strong>. A blue badge on a folder or 
 
111
                    package node marks folders or packages that contain locally modified 
 
112
                    or new files. In the case of packages, this badge applies only to the 
 
113
                    package itself and not its subpackages. For folders, the badge indicates 
 
114
                    local modifications in that folder or any of its subfolders.</td>
 
115
            </tr>
 
116
            <tr>
 
117
                <td><img src="images/red_badge.png" alt="red badge"></td>
 
118
                <td><strong>Conflict Badge</strong>. A red badge on a folder or package node
 
119
                    marks folders or packages that contain files for which the repository 
 
120
                    copy of the file contains changes which conflict with the local version. 
 
121
                    In case of packages, this badge applies only to the package itself and not 
 
122
                    its subpackages. For folders, the badge indicates local modifications in 
 
123
                    that folder or any of its subfolders.</td>
 
124
            </tr>
 
125
        </table>
 
126
        
 
127
        <ul class="note">
 
128
            <li>Note that the parent folders (or packages) of files excluded from commits
 
129
                and displayed in the strike-through style will not display badges if they 
 
130
                are modified.</li>
 
131
        </ul>
 
132
        
 
133
        <dl>
 
134
            <dt><a name="seealso">See Also</a></dt>
 
135
            <dd><a href="mercurial-quickref.html">Mercurial Tasks: Quick Reference</a></dd>            
 
136
        </dl>
 
137
        
 
138
        <hr><small><a href="credits.html">Legal Notices</a></small>
 
139
        <br><br><br>
 
140
    </body>
 
141
</html>