-------------------------------------------------------------------------------
help for fsx
-------------------------------------------------------------------------------

Show names of files in compact form (Unix-friendly defaults)

fsx [filespec [filespec [ ... ]], all ]

Description

fsx is a fork of fs. Both commands list the names of files in compact form. Note that files do not include folders or directories. The change in the fsx fork is that it suppresses hidden Unix files by default (much like the Stata command ls or the Unix command of the same name). These files are revealed with the all option, similar to the "ls -a" syntax in Unix.

With no arguments, fsx lists names of files in the current folder or directory but excludes hidden files. Otherwise, it follows file specifications. A file specification filespec is a filename or (more commonly) a set of filenames indicated by the use of wildcards * or ?. A folder or directory prefix should be given for files outside the current directory.

See help on dir or ls for listing the names of files with more detailed information. Unlike either of those commands, fsx may be given more than one file specification. Like dir or ls, but unlike the original fs command, fsx suppresses hidden files.

The list of filenames is returned in r(files), so long as that is not empty.

Remarks

It is recommended that even if you use Windows, you use forward slashes / rather than backward slashes \. Stata will understand and there will then be no clash with other meanings for the backward slash.

This command has been successfully tested on Windows but is most relevant for Unix (i.e., Mac, Linux, Solaris) as these operating systems use hidden files marked by leading dots which most Unix users will prefer to leave alone.

Options all allows a query to return hidden files, which are otherwise suppressed. When this option is used, fsx behaves exactly like fs.

Examples

. fsx

. fsx, all

. fsx *.dta

. fsx *.ado *.hlp

. fsx /ado/plus/f/*.ado

. fsx *.gph . foreach f in `r(files)' { . graph use `f' . more . }

Saved results

r(files) files matching the query

Acknowledgements

This command was forked from the original fs by Nick Cox. Please direct all support questions specifically about fsx to Rossman.

Author

Gabriel Rossman, UCLA, USA. rossman@soc.ucla.edu

Nicholas J. Cox, Durham University, U.K. n.j.cox@durham.ac.uk

Also see

Manual: [D] dir

Online: help for dir, help for extended macro functions, help for folders (if installed), help for fs (if installed)