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:54 UTC
Message-ID
<20210706205439.75015-1-andrew@furrypaws.ca>
In-Reply-To
<xmqqczrvl8kl.fsf@gitster.g>

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 | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/Documentation/gitignore.txt b/Documentation/gitignore.txt
index 53e7d5c914..534cda5747 100644
--- a/Documentation/gitignore.txt
+++ b/Documentation/gitignore.txt
@@ -27,10 +27,10 @@ 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
+   as the path, or in any parent directory in the same repository, 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
    files generated as part of the project build.
-- 
2.31.1
Previous: Junio C HamanoNext: Andrew Berry
Message 8 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.