# # # rename "locale/help/C/figures/information-button.png" # to "locale/help/C/figures/revision-history-button.png" # # patch "locale/help/C/figures/annotate-button.png" # from [ed645125ce0c690adf1adb58c04bb8bdae8a67d6] # to [95933862b31beab00266b2cb7d8e57b03a916a0b] # # patch "locale/help/C/figures/branch-combobox-entry-with-completion.png" # from [e2dedfa169dd59911565cfe784e2e0f9c50c6fc1] # to [8e408586db6223ea4bf603cdf74e27e3a8575038] # # patch "locale/help/C/figures/compare-button.png" # from [bff220db71820c703f5c96cc535e3ee1ef3ae6cc] # to [5e082cc84a13c568597a70296a94c4dc175f6696] # # patch "locale/help/C/figures/differences-window.png" # from [60462b429b0e070fd39f5e668abfe1a47576b8d4] # to [e145c8ad63a9fbf5d64ec73b7c9408f703b07f0a] # # patch "locale/help/C/figures/external-compare-button.png" # from [ecef1780fd98de237e210bd1c734866969228f93] # to [9f4de021cd10c1ea2528633b357df5b6d2ad7a85] # # patch "locale/help/C/figures/file-viewer-button.png" # from [1bd9580ff886459810717952a65cc87d7a751609] # to [9811c52fcdda7666e3f63cbd66059deea115b9e3] # # patch "locale/help/C/figures/main-window-empty.png" # from [3b59d32dc7b7b6eb08e2d04ca6cec87a527fd7af] # to [4e48f05633e26e2b4cc90a6cb1b6601c02e45de0] # # patch "locale/help/C/figures/main-window-showing-file.png" # from [804aa726e4d882eae939e92c16ac1d7acfa61a05] # to [73dda004a590d4caf4e9808379ebbd5fbbe91bc3] # # patch "locale/help/C/figures/main-window-showing-hex-dump.png" # from [cf3d0de8992c968def46eff63e55a5f6042ec742] # to [209b8175897cfa9176846d2ba8719d92ae84f7d1] # # patch "locale/help/C/figures/main-window-showing-image-file.png" # from [039decb583674e9e192f39d50d1b0351ead4e038] # to [7a6e2a746b5672dd1866937e46489d52e86c6c42] # # patch "locale/help/C/figures/main-window-showing-tooltip-and-selection.png" # from [8a15de7f62aac851626f86ae6447f413aa790df1] # to [319d8047ff8a96c5afec950a28f367e49c59a618] # # patch "locale/help/C/figures/montone-viz-button.png" # from [b7cfa3d6846c70c7c64910e5408f5ec5b9057081] # to [fa79ff73fbb41166f4cc89e3d9fa4ed04bd207ab] # # patch "locale/help/C/figures/multiple-revisions-dialog.png" # from [d6ce0c3c202e718c1add9157972cd6fb321a4fc0] # to [f9836165dd717c8a7dfd72981780e7f50d77cd0f] # # patch "locale/help/C/figures/open-database-dialog.png" # from [6f9179894083ff6a4b367ab5971524bc0f0ce6a5] # to [191f514be00c382796f7b6dd23f11a629ac658ca] # # patch "locale/help/C/figures/preferences-window.png" # from [557e705a20e42b196d9db661fcd274a738375ae3] # to [6f3481cdb60057eaa35bba751f70b77831fd51d8] # # patch "locale/help/C/figures/revision-history-button.png" # from [2dafc20c278e3c7763bf89038b7d0b36d37e63ac] # to [f70f0a8c265b29cc8fb9fe84d994b619852ab690] # # patch "locale/help/C/figures/revision-history-window.png" # from [7b20bb908d25195656f5f7b90256ed1136570850] # to [d9cdfc71d07799c3e5652e7d8ac34a7dde13b95d] # # patch "locale/help/C/mtn-browse.xml" # from [9a72965e410b4f7c40a36ccbf853ab4e582e6da4] # to [a55843fc1c253c6ef12c570c20c31a3f49dcf96f] # ============================================================ # locale/help/C/figures/annotate-button.png is binary ============================================================ # locale/help/C/figures/branch-combobox-entry-with-completion.png is binary ============================================================ # locale/help/C/figures/compare-button.png is binary ============================================================ # locale/help/C/figures/differences-window.png is binary ============================================================ # locale/help/C/figures/external-compare-button.png is binary ============================================================ # locale/help/C/figures/file-viewer-button.png is binary ============================================================ # locale/help/C/figures/main-window-empty.png is binary ============================================================ # locale/help/C/figures/main-window-showing-file.png is binary ============================================================ # locale/help/C/figures/main-window-showing-hex-dump.png is binary ============================================================ # locale/help/C/figures/main-window-showing-image-file.png is binary ============================================================ # locale/help/C/figures/main-window-showing-tooltip-and-selection.png is binary ============================================================ # locale/help/C/figures/montone-viz-button.png is binary ============================================================ # locale/help/C/figures/multiple-revisions-dialog.png is binary ============================================================ # locale/help/C/figures/open-database-dialog.png is binary ============================================================ # locale/help/C/figures/preferences-window.png is binary ============================================================ # locale/help/C/figures/revision-history-button.png is binary ============================================================ # locale/help/C/figures/revision-history-window.png is binary ============================================================ --- locale/help/C/mtn-browse.xml 9a72965e410b4f7c40a36ccbf853ab4e582e6da4 +++ locale/help/C/mtn-browse.xml a55843fc1c253c6ef12c570c20c31a3f49dcf96f @@ -6,7 +6,7 @@ - + ] > @@ -102,19 +102,27 @@ GNOME or DocBook. than the current revision --> - &APP; Manual V&VERSION; + &APP; Manual V0.01 02 May 2009 Anthony Cooper CooSoft + + &APP; Manual V&VERSION; + 08 November 2009 + + Anthony Cooper + CooSoft + + This is version &VERSION; of the &APP; manual. Feedback To report a fault or make a suggestion regarding the &APP; application or this manual, please email address@hidden. - + @@ -235,7 +243,7 @@ GNOME or DocBook. So if you typed in net.venge.monotone.contrib.lib.automate-stdio as the branch and then left clicked on the   button then you would have something looking like that shown in the figure below.
- A Branch ComboBox Entry Field Showing Its Completion List + A Branch Combobox Entry Field Showing Its Completion List Branch combobox entry field showing a reduced set of completion options via its pull down list. @@ -406,7 +414,7 @@ GNOME or DocBook. Runs Monotone Viz. Any selected branch and revision details will be passed to Monotone Viz so that it can graph the specific branch and select the revision on that branch. - + Displays a Revision History window for the selected revision, showing its change history right back to the earliest revision on that path (see ). @@ -482,7 +490,7 @@ GNOME or DocBook. Displays a Annotated Listing window for the currently selected file. This window shows who changed what, when they did it and the revision under which the change was made. - + Displays a File History window for the currently selected file, showing its change history right back to the earliest revision of that file (see ). @@ -570,19 +578,19 @@ GNOME or DocBook. - - Tool-Tips And Selection + + Tooltips And Selection - Tool-tips in this application work as expected. For most widgets, hovering over them will display an explanatory tool-tip after a few seconds. However, in the case of entry fields, in order not to interfere with typing, tool-tips only come up when you hover over an entry field's label rather than the entry box itself. Tool-tips are also used on the values displayed in information fields so that if they get truncated by the size of the window then one can always view their full value via a tool-tip. + Tooltips in this application work as expected. For most widgets, hovering over them will display an explanatory tooltip after a few seconds. However, in the case of entry fields, in order not to interfere with typing, tooltips only come up when you hover over an entry field's label rather than the entry box itself. Tooltips are also used on the values displayed in information fields so that if they get truncated by the size of the window then one can always view their full value via a tooltip. Most text items can be selected in the normal way with the mouse. However, the values in all information fields can also be selected. In the case where the value gets truncated then one can still select the entire value by treble left clicking with the mouse. The following figure illustrates the two points made above in a rather artificial way. It shows a Monotone Browser window where the user has treble left clicked on the value inside the File field and then moved the mouse over to the Change Log field.
- A Monotone Browser Window Showing Tool-Tips And Text Selection + A Monotone Browser Window Showing Tooltips And Text Selection - A Monotone Browser window showing a tool-tip and the selection of text inside an information label. + A Monotone Browser window showing a tooltip and the selection of text inside an information label.
@@ -601,7 +609,7 @@ GNOME or DocBook. This chapter covers the Advanced Find dialog window and how it can be used to perform more complex queries on a database. - This dialog window concerns itself with finding a particular revision in the database. If you want to find a particular file based upon some search criteria within a revision then, once the revision has been displayed, use the Monotone Browser window's Find Files button to actually search for the file(s). + This dialog window concerns itself with finding a particular revision in the database. If you want to find a particular file based upon some search criteria within a revision then, once the revision has been displayed, use the Monotone Browser window's Find Files button to actually search for the file(s) (see ). @@ -642,24 +650,18 @@ GNOME or DocBook. Simple Queries - This is the default query mode. Having read the previous section, one would be forgiven for thinking what is the point?. Well there are two reasons why you may want to use this mode: + This is the default query mode. Having read the previous section, one would be forgiven for thinking what is the point?. Well the main reason for using it is if you want to look at a revision's change log before selecting it. This can be particularly useful when the tagged revision that you attempted to select in the parent Monotone Browser window is not unique on the currently selected branch and something like the following dialog window pops up. - - - You may simply want to look at a revision's change log before selecting it. - - - The tagged revision that you attempted to select in the parent Monotone Browser window is not unique on the currently selected branch and something like the following dialog window popped up. -
- A `Multiple Revisions' Dialog Window - - A multiple revisions dialog window. - - -
- - +
+ A `Multiple Revisions' Dialog Window + + A multiple revisions dialog window. + + +
+ Of course one could simply use the Revisions combobox in the above dialog window, but in most cases people would not know the id of the revision that they are after. + Once you have completed your simple query, a list of matching revisions will be displayed in the Revisions panel. When one of these revisions is selected, its full change log is displayed in the Details panel on the right. Left clicking on the OK button will dismiss the Advanced Find dialog window and load the selected revision into the parent Monotone Browser window. @@ -907,7 +909,7 @@ GNOME or DocBook. Files named - Combobox entry field where one can enter a file name pattern that is to be searched for. File name patterns can be those used with commands like ls(1). + A combobox entry field where one can enter a file name pattern that is to be searched for. File name patterns can be those used with commands like ls(1). Case sensitive @@ -934,7 +936,7 @@ GNOME or DocBook. Files containing - Combobox entry field where one can enter a text pattern that is to be searched for inside each file. + A combobox entry field where one can enter a text pattern that is to be searched for inside each file. Case sensitive @@ -981,7 +983,7 @@ GNOME or DocBook. Files last modified by - Combobox entry field where one can enter the id of the author that is to be searched for on each file. + A combobox entry field where one can enter the id of the author that is to be searched for on each file. @@ -1411,6 +1413,14 @@ GNOME or DocBook. History size Determines how much history is retained for ordinary combobox entry's fields via their pull down lists. This history is saved to disk so that it is available the next time you run &APP;. This does not apply to Branch and Revision combobox entry fields as they are used to select items out of specific lists retrieved from the database. + + Static lists + If this is ticked then the pull down lists on Branch and Revision combobox entry fields are not updated each time the user enters something into the corresponding entry field. Otherwise the pull down lists are updated on each key press. + + + Show tooltips + If this is ticked then each time an invalid character is entered into a Branch or Revision combobox entry field a completion tooltip is displayed just below it that shows the same explanatory text that is displayed in the status bar at the bottom of the window. Otherwise no completion style tooltips are displayed. + @@ -1438,19 +1448,23 @@ GNOME or DocBook. Show suspended revisions - If this is ticked then suspended revisions are included in Branch combobox entry pull down lists. Otherwise only active branches are listed.Apart from the obvious use for this setting, it can be useful when there are a large number of branches in the database, as not bothering to weed out suspended branches speeds things up considerably. + If this is ticked then the branches of suspended revisions are included in Branch combobox entry pull down lists. Otherwise only active branches are listed.Apart from the obvious use for this setting, it can be useful when there are a large number of branches in the database, as not bothering to weed out suspended branches speeds things up considerably. Detailed file listings If this is ticked then the Last Update and Author columns are shown in Revision Browser panels. Otherwise only the file's icon and name are shown. Not displaying these two columns speeds up the displaying of a directory's contents at the expense of less information. + Folders come first + If this is ticked then folders are displayed before any files in directory listings. Otherwise both folders and files are displayed in strict alphabetical order. + + Show line numbers If this is ticked then line numbers are shown by default when viewing the contents of files. Otherwise no line numbers are shown by default. - Static branch and revision lists - If this is ticked then the pull down lists on Branch and Revision combobox entry fields are not updated each time the user enters something into the corresponding entry field. Otherwise the pull down lists are updated on each key press. + Binary threshold + This threshold is used to decide whether a file's contents are textual or binary in nature. When &APP; is determining the amount of non-printable characters in a file it breaks the data down into 10KB chunks and calculates the percentage of non-printable characters in that chunk. As soon as a chunk's percentage of non-printable characters is greater than this threshold the file is considered to be binary and not textual. This process is designed for efficiency as sometimes many hundreds of files need to be scanned per second.