-USING: help.markup help.syntax io.backend io.files strings ;
+USING: help.markup help.syntax io.backend io.files io.directories strings ;
 IN: io.pathnames
 
 HELP: path-separator?


HELP: normalize-path
{ $values { "str" "a pathname string" } { "newstr" "a new pathname string" } }
{ $description "Called by words such as " { $link <file-reader> } " and " { $link <file-writer> } " to prepare a pathname before passing it to underlying code." } ;

HELP: <pathname>
{ $values { "string" "a pathname string" } { "pathname" pathname } }

{ $values { "dir" string } }
{ $description "Outputs the user's home directory." } ;

ARTICLE: "io.pathnames" "Pathname manipulation"
"Pathname manipulation:"
{ $subsection parent-directory }
{ $subsection file-name }
{ $subsection last-path-separator }
{ $subsection append-path }
"Pathname presentations:"
{ $subsection pathname }
{ $subsection <pathname> }
"Literal pathnames:"
{ $subsection POSTPONE: P" }
"Low-level word:"
{ $subsection normalize-path } ;

ABOUT: "io.pathnames"
