sublime-undocs icon indicating copy to clipboard operation
sublime-undocs copied to clipboard

Document what is a folder name for Search in Files

Open kgrossjo opened this issue 7 years ago • 4 comments

The file search_and_replace_files.rst states:

Adding individual directories (Unix-style paths, even on Windows)

It doesn't talk about absolute versus relative paths, though. I believe if I have a project with just one folder C:/x in it, then entering foo/bar means C:/x/foo/bar. It should state this explicitly.

Also, what happens when I have more than one folder in my project?

And if I enter foo/bar, will it find all files under this folder hierarchy? E.g. will it find a file C:/x/foo/bar/a/b.c?

kgrossjo avatar Jul 24 '17 10:07 kgrossjo

It actually means /C/x/foo/bar, which may or may not be a bug internally. I agree that we should add an example for this for as long as this is the case, however.

FichteFoll avatar Aug 16 '17 17:08 FichteFoll

I see the text has been changed. Thanks. However, what happens if the project contains more than one folder? That's not explained.

Also, it doesn't say whether it traverses the whole directory hierarchy or not.

Also, it could be clearer when explaining how they interact. It says we can "combine filters using commas", but it's not clear. The example shows three filters, let me construct two examples from this using two filters:

  • <current file>,<open folders>: Here, the comma must be a union operation, because otherwise it would be the same as <current file>, and thus it wouldn't make sense.
  • -*.txt,<open folders>: Here, the comma must be an intersection operation, because otherwise it would be the same as <open folders>, and thus it wouldn't make sense.

kgrossjo avatar Aug 16 '17 21:08 kgrossjo

Yes, this section needs a revisit.

However, nobody changed anything on that page in a year, so your response kind of confuses me.

FichteFoll avatar Aug 16 '17 21:08 FichteFoll

It has this sentence: "Relative paths in filters are interpreted to start at the root of the active project." How could I have missed it before? :-(

kgrossjo avatar Aug 16 '17 21:08 kgrossjo