Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Workers List <zsh-workers.zsh.org>
List-Post: <mailto:zsh-workers@zsh.org>
List-Help: <mailto:zsh-workers-help@zsh.org>
X-Qmail-Scanner-Diagnostics: from mail-pf0-f177.google.com by f.primenet.com.au (envelope-from <schaefer@brasslantern.com>, uid 7791) with qmail-scanner-2.11 
 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1.  
 Clear:RC:0(209.85.192.177):SA:0(0.0/5.0):. 
 Processed in 0.111425 secs); 17 Aug 2016 16:53:32 -0000
X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=0.0 required=5.0 tests=T_DKIM_INVALID
	autolearn=unavailable autolearn_force=no version=3.4.1
X-Envelope-From: schaefer@brasslantern.com
X-Qmail-Scanner-Mime-Attachments: |
X-Qmail-Scanner-Zip-Files: |
Received-SPF: none (ns1.primenet.com.au: domain at brasslantern.com does not designate permitted sender hosts)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=brasslantern-com.20150623.gappssmtp.com; s=20150623;
        h=from:message-id:date:in-reply-to:comments:references:to:subject
         :mime-version;
        bh=00k1J/NmJ7Vi3Q7ewSu3BKyO6miJSbpGZ6R3SohQaMQ=;
        b=YvsdaoLmHmXMVicGz6CtEE3vKWxOQDHHELRNM49yIPm0hpzGptMyKrW5GNRJcp9/LY
         m8HqGBJDwQOrFnvHdItAX6Qdqpm3OMFp1B4MqhHeOYndNFFpaSRu+n05UNei1sh92s+b
         R1POQ10LKna/xBNZclF1tqanx46HHxUzXCMA7Ngdz6Wmwp5WCThsX1v51PSEtFGsqaE/
         MsI2rgWTki/WoAQ97txud/YTe1SPf0qdjpAalVZLVCILqgRX+H3560NvBpToqv3gQBPb
         1MVODjOvanX1vhOMBPDEh/5/p3i97NzVxL1WP00I9NIPahx2ff1A87t+QApvYwIkTL9j
         TtJA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20130820;
        h=x-gm-message-state:from:message-id:date:in-reply-to:comments
         :references:to:subject:mime-version;
        bh=00k1J/NmJ7Vi3Q7ewSu3BKyO6miJSbpGZ6R3SohQaMQ=;
        b=ZMuctlmAtnYqc4He/opZaCX2hFeL623B+HfZu//VnjBk5xh4a3wVlbOPBSqIrtibeU
         DD4XcxE6WrciJBU9MAdyRhanWJ+SAxxJ+UbKAPJlk9dixNGgr6dWeiVJknn6y8/tGdNQ
         fXSgYOHtWEneHxJ7GlvImiALpm+p1RlxXIw3vjEidXyx5j4OqLKhZ3k1ruNKN5eS5lsK
         YJkHsvciweZfhK/gZbg1E4TeE0vartNtSWedwgTQCzWmghB1XoQcFpIrlvxTxhTz3wQW
         aR9f//7EMKW70lAw5LZQREr2w1IoOT19kV2USMNT1UsTP9s56e0v6nXFzV9P+fEkacmD
         Fp0w==
X-Gm-Message-State: AEkoouvZA4gv1yCn3J+EbGRgLHd63Kl5lgr63S5U3V8MvAcENICB2nXFPnN9t800pD9+oQ==
X-Received: by 10.98.28.142 with SMTP id c136mr15991156pfc.131.1471452802870;
        Wed, 17 Aug 2016 09:53:22 -0700 (PDT)
From: Bart Schaefer <schaefer@brasslantern.com>
Message-Id: <160817095330.ZM21532@torch.brasslantern.com>
Date: Wed, 17 Aug 2016 09:53:30 -0700
In-Reply-To: <20160817163140.GA9003@tarsus.local2>
Comments: In reply to Daniel Shahaf <d.s@daniel.shahaf.name>
        "Re: [PATCH] Document _canonical_paths." (Aug 17,  4:31pm)
References: <1471387721-5256-1-git-send-email-danielsh@tarsus.local2> 
	<160816232827.ZM19685@torch.brasslantern.com> 
	<20160817163140.GA9003@tarsus.local2>
X-Mailer: OpenZMail Classic (0.9.2 24April2005)
To: zsh-workers@zsh.org
Subject: Re: [PATCH] Document _canonical_paths.
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Seq: zsh-workers 39052

On Aug 17,  4:31pm, Daniel Shahaf wrote:
}
} > I don't understand why you want to remove comments from the function files.
} 
} To avoid duplication.

I think of function files as source code.  You wouldn't remove comments
from the C source code just because there's a manual page, would you?

Also manual pages are installed separately in many cases (even the zsh
tarballs are split to separate the docs) and therefore sometimes the
doc isn't installed at all on a given machine.  It's not duplication
when one of the copies doesn't exist ...