{smcl}
{* *! version 1.1.3  11feb2011}{...}
{vieweralsosee "[D] dir" "mansection D dir"}{...}
{vieweralsosee "" "--"}{...}
{vieweralsosee "[D] cd" "help cd"}{...}
{vieweralsosee "[D] copy" "help copy"}{...}
{vieweralsosee "[D] erase" "help erase"}{...}
{vieweralsosee "[D] mkdir" "help mkdir"}{...}
{vieweralsosee "[D] rmdir" "help rmdir"}{...}
{vieweralsosee "[D] shell" "help shell"}{...}
{vieweralsosee "[D] type" "help type"}{...}
{viewerjumpto "Syntax" "dir##syntax"}{...}
{viewerjumpto "Description" "dir##description"}{...}
{viewerjumpto "Option" "dir##option"}{...}
{viewerjumpto "Examples" "dir##examples"}{...}
{title:Title}

{p2colset 5 16 18 2}{...}
{p2col :{manlink D dir} {hline 2}}Display filenames{p_end}
{p2colreset}{...}


{marker syntax}{...}
{title:Syntax}

{p 8 13 2}
{{cmd:dir}{c |}{cmd:ls}} [{cmd:"}][{it:filespec}][{cmd:"}]
[{cmd:,} {opt w:ide}]

{p 4 11 2}
Note:  Double quotes must be used to enclose {it:filespec} if the name
contains spaces.


{marker description}{...}
{title:Description}

{pstd}
{cmd:dir} and {cmd:ls} -- they work the same way -- list the names of
files in the specified directory; the names of the commands come from names
popular on Unix and Windows computers.  {it:filespec} may be any valid
Mac, Unix, or Windows file path or file specification 
(see {findalias frfilenames}) and may include "{cmd:*}"
to indicate any string of characters.


{marker option}{...}
{title:Option}

{phang}
{opt wide} under Mac and Windows produces an effect similar to
specifying {cmd:/W} with the DOS {cmd:dir} command -- it compresses the
resulting listing by placing more than one filename on a line.  Under Unix, it
produces the same effect as typing {cmd:ls -F -C}.  Without the {opt wide}
option, {cmd:ls} is equivalent to {cmd:ls -F -l}.


{marker examples}{...}
{title:Examples}

    Mac:
	{cmd:. ls}
	{cmd:. ls, w}
	{cmd:. ls *.dta}
	{cmd:. ls ~:mydata:*.dta}
	{cmd:. ls "~:My Data":*.dta}

    Unix:
	{cmd:. ls}
	{cmd:. ls, w}
	{cmd:. ls *.dta}
	{cmd:. ls ~/mydata/*.dta}

    Windows:
	{cmd:. dir}
	{cmd:. dir, w}
	{cmd:. dir *.dta}
	{cmd:. dir \mydata\*.dta}
