On Sunday, November 30, 2014, Nguyễn Thái Ngọc Duy <pclouds@xxxxxxxxx> wrote: > > This is more user friendly version of ls-files: > > * it's automatically colored and columnized > * it refreshes the index like all porcelain commands > * it defaults to non-recursive behavior like ls > * :(glob) is on by default so '*.c' means a.c but not a/b.c, use > '**/*.c' for that. > * auto pager > > The name 'ls' is not taken. It is left for the user to make an alias > with better default options. I understand that your original version was named git-ls and that you renamed it to git-list-files in order to leave 'ls' available so users can create an 'ls' alias specifying their own default options. Would it make sense, however, to restore the name to git-ls and allow users to set default options via a config variable instead? Doing so would make the short-and-sweet git-ls command work for all users out-of-the-box, which might be well appreciated by Unix users. More below. > Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@xxxxxxxxx> > --- > diff --git a/Documentation/git-list-files.txt b/Documentation/git-list-files.txt > new file mode 100644 > index 0000000..3039e1e > --- /dev/null > +++ b/Documentation/git-list-files.txt > @@ -0,0 +1,80 @@ > +git-list-files(1) > +=============== > + > +NAME > +---- > +git-list-files - List files > + > +SYNOPSIS > +-------- > +[verse] > +'git list-files [options] [<pathspec>...] > + > +DESCRIPTION > +----------- > +List files (by default in current working directory) that are in the > +index. Depending on the chosen options, maybe only modified files in > +working tree are shown, or untracked files... > + > +OPTIONS > +------- > +-c:: > +--cached:: > + Show cached files (default) I realize that this mirrors what is in git-ls-files.txt, but: s/$/./ > +-d:: > +--deleted:: > + Show cached files that are deleted on working directory s/$/./ > +-m:: > +--modified:: > + Show cached files that have modification on working directory s/$/./ > +-o:: > +--others:: > + Show untracked files (and only unignored ones unless -i is s/-i/`-i`/ > + specified) s/$/./ > +-i:: > +--ignored:: > + Show only ignored files. When showing files in the index, > + print only those matched by an exclude pattern. When showing > + "other" files, show only those matched by an exclude pattern. > + > +-u:: > +--unmerged:: > + Show unmerged files s/$/./ > +--color[=<when>]:: > +--no-color:: > + Color file names. The value must be `always`, `never`, or > + `auto`. `--no-color` is equivalent to > + `--color=never`. `--color` is equivalent to > + `--color=auto`. See configuration variable `color.list-files` > + for the default settings. > + > +--column[=<options>]:: > +--no-column:: > + Display files in columns. See configuration variable column.ui s/column.ui/`column.ui`/ > + for option syntax. `--column` and `--no-column` without options > + are equivalent to 'always' and 'never' respectively. > + > +--max-depth=<depth>:: > + For each <pathspec> given on command line, descend at most <depth> > + levels of directories. A negative value means no limit. > + This option is ignored if <pathspec> contains active wildcards. > + In other words if "a*" matches a directory named "a*", > + "*" is matched literally so --max-depth is still effective. > + The default is `--max-depth=0`. > + > +<pathspec>:: > + Files to show. :(glob) magic is enabled and recursion disabled > + by default. > + > +SEE ALSO > +-------- > +linkgit:git-ls-files[1] > + > +GIT > +--- > +Part of the linkgit:git[1] suite -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html