git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] docs: .gitignore parsing is to the top of the repo

From
Andrew Berry <andrew@furrypaws.ca>
Date
Jul 6, 2021, 20:57 UTC
Message-ID
<20210706205712.75270-1-andrew@furrypaws.ca>
In-Reply-To
<20210706205439.75015-1-andrew@furrypaws.ca>

The current documentation reads as if .gitignore files will be parsed in every parent directory, and not until they reach a repository boundary. This clarifies the current behaviour.

As well, this corrects 'toplevel' to 'top-level', matching usage for 'top-level domain'.

Signed-off-by: Andrew Berry <andrew@furrypaws.ca>
---
 Documentation/gitignore.txt | 11 +++++------
 1 file changed, 5 insertions(+), 6 deletions(-)
diff --git a/Documentation/gitignore.txt b/Documentation/gitignore.txt
index 53e7d5c914..af8f231cc1 100644
--- a/Documentation/gitignore.txt
+++ b/Documentation/gitignore.txt
@@ -27,12 +27,11 @@ precedence, the last matching pattern decides the outcome):
    them.
 
  * Patterns read from a `.gitignore` file in the same directory
-   as the path, or in any parent directory, with patterns in the
-   higher level files (up to the toplevel of the work tree) being overridden
-   by those in lower level files down to the directory containing the file.
-   These patterns match relative to the location of the
-   `.gitignore` file.  A project normally includes such
-   `.gitignore` files in its repository, containing patterns for
+   as the path, or in any parent directory (up to the top-level of the work
+   tree), with patterns in the higher level files being overridden by those in
+   lower level files down to the directory containing the file. These patterns
+   match relative to the location of the `.gitignore` file.  A project normally
+   includes such `.gitignore` files in its repository, containing patterns for
    files generated as part of the project build.
 
  * Patterns read from `$GIT_DIR/info/exclude`.
-- 
2.31.1
Previous: Andrew BerryNext: Junio C Hamano
Message 9 of 16 in “docs: .gitignore in parents is current repo only”
  1. docs: .gitignore in parents is current repo onlyAndrew Berry, Jul 2, 2021
  2. Junio C HamanoJul 3, 2021
  3. Bagas SanjayaJul 3, 2021
  4. Andrew BerryJul 5, 2021
  5. Junio C HamanoJul 5, 2021
  6. Andrew BerryJul 5, 2021
  7. Junio C HamanoJul 6, 2021
  8. docs: .gitignore parsing is to the top of the repoAndrew Berry, Jul 6, 2021
  9. docs: .gitignore parsing is to the top of the repoAndrew Berry, Jul 6, 2021
  10. Junio C HamanoJul 6, 2021
  11. Junio C HamanoJul 7, 2021
  12. Andrew BerryJul 7, 2021
  13. Junio C HamanoJul 7, 2021
  14. Andrew BerryJul 18, 2021
  15. Junio C HamanoJul 19, 2021
  16. Junio C HamanoJul 6, 2021

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.