From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-3.8 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=no autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 5369AC433E1 for ; Sun, 17 May 2020 02:24:35 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by mail.kernel.org (Postfix) with ESMTP id 3203620671 for ; Sun, 17 May 2020 02:24:35 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726980AbgEQCYW (ORCPT ); Sat, 16 May 2020 22:24:22 -0400 Received: from smtp-1.his.com ([216.194.195.13]:45457 "EHLO smtp-1.his.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726948AbgEQCYT (ORCPT ); Sat, 16 May 2020 22:24:19 -0400 Received: from localhost (localhost [127.0.0.1]) by smtp-1.his.com (Postfix) with ESMTP id A8307607B0 for ; Sat, 16 May 2020 22:14:48 -0400 (EDT) X-Virus-Scanned: Debian amavisd-new at smtp-1.his.com Received: from smtp-1.his.com ([127.0.0.1]) by localhost (smtp-1.his.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id xxk9+cWPZHfG for ; Sat, 16 May 2020 22:14:45 -0400 (EDT) Received: from smtp-nf-201.his.com (smtp-nf-201.his.com [216.194.196.93]) by smtp-1.his.com (Postfix) with ESMTP id 10AE860798 for ; Sat, 16 May 2020 22:14:45 -0400 (EDT) Received: from cuda201.his.com (cuda201.his.com [216.194.196.22]) by smtp-nf-201.his.com (Postfix) with ESMTPS id 185356042B for ; Sat, 16 May 2020 22:14:44 -0400 (EDT) X-ASG-Debug-ID: 1589681683-061c41045a25b580001-QuoKaX Received: from smtp-nf-202.his.com (smtp-nf-202.his.com [216.194.196.20]) by cuda201.his.com with ESMTP id IlkvFHSpES5pH3Jm for ; Sat, 16 May 2020 22:14:43 -0400 (EDT) X-Barracuda-Envelope-From: keni@his.com X-Barracuda-RBL-Trusted-Forwarder: 216.194.196.20 Received: from zproxy101.his.com (zproxy101.his.com [18.218.2.49]) by smtp-nf-202.his.com (Postfix) with ESMTPS id 8A81260229 for ; Sat, 16 May 2020 22:14:43 -0400 (EDT) Received: from localhost (localhost.localdomain [127.0.0.1]) by zproxy101.his.com (Postfix) with ESMTP id 395F2177E8B; Sat, 16 May 2020 22:14:43 -0400 (EDT) X-Barracuda-RBL-IP: 18.218.2.49 X-Barracuda-Effective-Source-IP: zproxy101.his.com[18.218.2.49] X-Barracuda-Apparent-Source-IP: 18.218.2.49 Received: from zproxy101.his.com ([127.0.0.1]) by localhost (zproxy101.his.com [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id WsEgslYVmzKq; Sat, 16 May 2020 22:14:43 -0400 (EDT) Received: from localhost (localhost.localdomain [127.0.0.1]) by zproxy101.his.com (Postfix) with ESMTP id 22D46177E99; Sat, 16 May 2020 22:14:43 -0400 (EDT) X-Virus-Scanned: amavisd-new at zproxy101.his.com Received: from zproxy101.his.com ([127.0.0.1]) by localhost (zproxy101.his.com [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id uHUQ3X5nMKza; Sat, 16 May 2020 22:14:43 -0400 (EDT) Received: from kenilap.lorber.home (pool-74-96-209-77.washdc.fios.verizon.net [74.96.209.77]) by zproxy101.his.com (Postfix) with ESMTPSA id 05E54177E8B; Sat, 16 May 2020 22:14:42 -0400 (EDT) Received: (from keni@localhost) by kenilap.lorber.home (8.14.5/8.14.1) id 04H2EfKe037018; Sat, 16 May 2020 22:14:41 -0400 (EDT) From: Kenneth Lorber To: git@vger.kernel.org Cc: keni@hers.com Subject: [RFC PATCH 0/6] various documentation bits Date: Sat, 16 May 2020 22:13:38 -0400 X-ASG-Orig-Subj: [RFC PATCH 0/6] various documentation bits Message-Id: <1589681624-36969-1-git-send-email-keni@hers.com> X-Mailer: git-send-email 2.7.1.287.g4943984.dirty X-Barracuda-Connect: smtp-nf-202.his.com[216.194.196.20] X-Barracuda-Start-Time: 1589681683 X-Barracuda-URL: https://spam.his.com:443/cgi-mod/mark.cgi X-Virus-Scanned: by bsmtpd at his.com X-Barracuda-Scan-Msg-Size: 1290 X-Barracuda-BRTS-Status: 1 X-Barracuda-Spam-Score: 0.00 X-Barracuda-Spam-Status: No, SCORE=0.00 using global scores of TAG_LEVEL=1000.0 QUARANTINE_LEVEL=1000.0 KILL_LEVEL=6.0 tests= X-Barracuda-Spam-Report: Code version 3.2, rules version 3.2.3.81903 Rule breakdown below pts rule name description ---- ---------------------- -------------------------------------------------- Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org From: Kenneth Lorber This started as an effort to understand this section of config.txt: When inventing new variables for use in your own tool, make sure their names do not conflict with those that are used by Git itself and other popular tools, and describe them in your documentation. and grew from there. I don't expect this to be adopted as is, but I've found it much easier to discuss something concrete rather than an abstract "this is incomplete" or "this is hard to find." Cut from master. keni (6): Tell the glossary about core.hooksPath Add bit on extending git to Hacking Git Add namespace collision avoidance guidelines file Include NAMESPACE COLLISIONS doc into gitrepository-layout.txt Tell config.txt about NAMESPACE COLLISIONS Add NAMESPACE COLLISIONS reference to Hacking Git Documentation/config.txt | 4 +- Documentation/gitrepository-layout.txt | 2 + Documentation/glossary-content.txt | 10 ++- .../technical/namespace-collisions.txt | 86 +++++++++++++++++++ Documentation/user-manual.txt | 9 ++ 5 files changed, 106 insertions(+), 5 deletions(-) create mode 100644 Documentation/technical/namespace-collisions.txt -- 2.17.1