Fossil SCM

Revise proposed changes options and help text.

andygoth 2016-10-12 03:45 andygoth-changes
Commit 69b41682655375ff1ca2c2a31051bcad8bba749a
1 file changed +22 -13
+22 -13
--- src/checkin.c
+++ src/checkin.c
@@ -206,46 +206,55 @@
206206
** Report the change status of files in the current checkout.
207207
**
208208
** Each line of output is the name of a changed file, with paths shown
209209
** according to the "relative-paths" setting, unless overridden by the
210210
** --abs-paths or --rel-paths options.
211
-**
211
+**
212212
** By default, all changed files are selected for display. This behavior
213213
** can be overridden by using one or more filter options (listed below),
214214
** in which case only files with the specified change type(s) are shown.
215
+** As a special case, the --no-merge option does not inhibit this default.
216
+**
217
+** If no filter options are used, or if the --merge option is used, the
218
+** SHA1 hash of each merge contributor check-in version is displayed at
219
+** the end of the report. The --no-merge option is useful to display the
220
+** default set of changed files but not the merge contributors.
215221
**
216
-** If file change type classification is enabled, each output line starts
217
-** with a code describing the file's change type, e.g. EDITED or RENAMED.
218
-** This can be turned on or off using the --classify or --no-classify
219
-** options, respectively. By default, it is enabled only when more than
220
-** one change type is enabled (i.e. zero or multiple filter options or
221
-** --all are used) and disabled when only one change type is enabled.
222
+** If change type classification is enabled, each output line starts with
223
+** a code describing the file's change type, e.g. EDITED or RENAMED. It
224
+** is enabled by default except when exactly one filter option (besides
225
+** --merge or --no-merge) is used. The default can be overridden by the
226
+** --classify or --no-classify options.
222227
**
223228
** The "fossil changes -extra" command is equivalent to "fossil extras".
224229
**
225
-** Options:
230
+** General options:
226231
** --abs-paths Display absolute pathnames.
227232
** --rel-paths Display pathnames relative to the current working
228233
** directory.
229234
** --sha1sum Verify file status using SHA1 hashing rather than
230235
** relying on file mtimes.
231
-** --header Identify the repository if any files are listed.
232
-** -v|--verbose Say "(none)" if no files are listed.
236
+** --header Identify the repository if report is non-empty.
237
+** -v|--verbose Say "(none)" if the change report is empty.
233238
** --classify Start each line with the file's change type.
234239
** --no-classify Do not print file change types.
235240
**
236241
** Filter options:
237
-** --edited Display edited files.
242
+** --edited Display edited, merged, and conflicted files.
243
+** --updated Display files updated by merge/integrate.
244
+** --modified Combination of the above two options.
238245
** --missing Display missing files.
239246
** --added Display added files.
240247
** --deleted Display deleted files.
241248
** --renamed Display renamed files.
242
-** --conflict Display merge conflict files.
243
-** --unmodified Display unmodified files.
249
+** --conflict Display files having merge conflicts.
244250
** --meta Display files with metadata changes.
251
+** --unmodified Display unmodified files.
245252
** --all Display all managed files, i.e. all of the above.
246253
** --extra Display unmanaged files.
254
+** --merge Display merge contributors.
255
+** --no-merge Do not display merge contributors.
247256
**
248257
** See also: extras, ls, status
249258
*/
250259
void changes_cmd(void){
251260
int useSha1sum = find_option("sha1sum", 0, 0)!=0;
252261
--- src/checkin.c
+++ src/checkin.c
@@ -206,46 +206,55 @@
206 ** Report the change status of files in the current checkout.
207 **
208 ** Each line of output is the name of a changed file, with paths shown
209 ** according to the "relative-paths" setting, unless overridden by the
210 ** --abs-paths or --rel-paths options.
211 **
212 ** By default, all changed files are selected for display. This behavior
213 ** can be overridden by using one or more filter options (listed below),
214 ** in which case only files with the specified change type(s) are shown.
 
 
 
 
 
 
215 **
216 ** If file change type classification is enabled, each output line starts
217 ** with a code describing the file's change type, e.g. EDITED or RENAMED.
218 ** This can be turned on or off using the --classify or --no-classify
219 ** options, respectively. By default, it is enabled only when more than
220 ** one change type is enabled (i.e. zero or multiple filter options or
221 ** --all are used) and disabled when only one change type is enabled.
222 **
223 ** The "fossil changes -extra" command is equivalent to "fossil extras".
224 **
225 ** Options:
226 ** --abs-paths Display absolute pathnames.
227 ** --rel-paths Display pathnames relative to the current working
228 ** directory.
229 ** --sha1sum Verify file status using SHA1 hashing rather than
230 ** relying on file mtimes.
231 ** --header Identify the repository if any files are listed.
232 ** -v|--verbose Say "(none)" if no files are listed.
233 ** --classify Start each line with the file's change type.
234 ** --no-classify Do not print file change types.
235 **
236 ** Filter options:
237 ** --edited Display edited files.
 
 
238 ** --missing Display missing files.
239 ** --added Display added files.
240 ** --deleted Display deleted files.
241 ** --renamed Display renamed files.
242 ** --conflict Display merge conflict files.
243 ** --unmodified Display unmodified files.
244 ** --meta Display files with metadata changes.
 
245 ** --all Display all managed files, i.e. all of the above.
246 ** --extra Display unmanaged files.
 
 
247 **
248 ** See also: extras, ls, status
249 */
250 void changes_cmd(void){
251 int useSha1sum = find_option("sha1sum", 0, 0)!=0;
252
--- src/checkin.c
+++ src/checkin.c
@@ -206,46 +206,55 @@
206 ** Report the change status of files in the current checkout.
207 **
208 ** Each line of output is the name of a changed file, with paths shown
209 ** according to the "relative-paths" setting, unless overridden by the
210 ** --abs-paths or --rel-paths options.
211 **
212 ** By default, all changed files are selected for display. This behavior
213 ** can be overridden by using one or more filter options (listed below),
214 ** in which case only files with the specified change type(s) are shown.
215 ** As a special case, the --no-merge option does not inhibit this default.
216 **
217 ** If no filter options are used, or if the --merge option is used, the
218 ** SHA1 hash of each merge contributor check-in version is displayed at
219 ** the end of the report. The --no-merge option is useful to display the
220 ** default set of changed files but not the merge contributors.
221 **
222 ** If change type classification is enabled, each output line starts with
223 ** a code describing the file's change type, e.g. EDITED or RENAMED. It
224 ** is enabled by default except when exactly one filter option (besides
225 ** --merge or --no-merge) is used. The default can be overridden by the
226 ** --classify or --no-classify options.
 
227 **
228 ** The "fossil changes -extra" command is equivalent to "fossil extras".
229 **
230 ** General options:
231 ** --abs-paths Display absolute pathnames.
232 ** --rel-paths Display pathnames relative to the current working
233 ** directory.
234 ** --sha1sum Verify file status using SHA1 hashing rather than
235 ** relying on file mtimes.
236 ** --header Identify the repository if report is non-empty.
237 ** -v|--verbose Say "(none)" if the change report is empty.
238 ** --classify Start each line with the file's change type.
239 ** --no-classify Do not print file change types.
240 **
241 ** Filter options:
242 ** --edited Display edited, merged, and conflicted files.
243 ** --updated Display files updated by merge/integrate.
244 ** --modified Combination of the above two options.
245 ** --missing Display missing files.
246 ** --added Display added files.
247 ** --deleted Display deleted files.
248 ** --renamed Display renamed files.
249 ** --conflict Display files having merge conflicts.
 
250 ** --meta Display files with metadata changes.
251 ** --unmodified Display unmodified files.
252 ** --all Display all managed files, i.e. all of the above.
253 ** --extra Display unmanaged files.
254 ** --merge Display merge contributors.
255 ** --no-merge Do not display merge contributors.
256 **
257 ** See also: extras, ls, status
258 */
259 void changes_cmd(void){
260 int useSha1sum = find_option("sha1sum", 0, 0)!=0;
261

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button