From mboxrd@z Thu Jan 1 00:00:00 1970 From: Junio C Hamano Subject: Re: Documentation/user-manual.txt, asciidoc and "--" escapes Date: Sat, 15 Nov 2008 04:07:53 -0800 Message-ID: <7vzlk15h0m.fsf@gitster.siamese.dyndns.org> References: <2c6b72b30811091052k77200785j722c8aed2beb7684@mail.gmail.com> <20081110100757.GA12868@diku.dk> <20081112000445.GB17662@diku.dk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: "Jonas Fonseca" , git@vger.kernel.org To: "Piotr Findeisen" X-From: git-owner@vger.kernel.org Sat Nov 15 13:09:32 2008 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1L1Jy0-0006gk-3q for gcvg-git-2@gmane.org; Sat, 15 Nov 2008 13:09:32 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754919AbYKOMIP (ORCPT ); Sat, 15 Nov 2008 07:08:15 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1754872AbYKOMIP (ORCPT ); Sat, 15 Nov 2008 07:08:15 -0500 Received: from a-sasl-fastnet.sasl.smtp.pobox.com ([207.106.133.19]:34107 "EHLO sasl.smtp.pobox.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754859AbYKOMIP (ORCPT ); Sat, 15 Nov 2008 07:08:15 -0500 Received: from localhost.localdomain (unknown [127.0.0.1]) by a-sasl-fastnet.sasl.smtp.pobox.com (Postfix) with ESMTP id ACF807DAC3; Sat, 15 Nov 2008 07:08:13 -0500 (EST) Received: from pobox.com (unknown [68.225.240.211]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-sasl-fastnet.sasl.smtp.pobox.com (Postfix) with ESMTPSA id 4F1247DAC2; Sat, 15 Nov 2008 07:08:03 -0500 (EST) User-Agent: Gnus/5.110006 (No Gnus v0.6) Emacs/21.4 (gnu/linux) X-Pobox-Relay-ID: 13F8B2DC-B30E-11DD-A397-9CEDC82D7133-77302942!a-sasl-fastnet.pobox.com Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: "Piotr Findeisen" writes: > However, this seems a bit messy -- fighting against asciidoc instead > of using it as it's designed to be used. IMHO, it's better to > explicitly escape non-punctuation "--" with "\" and write punctuation > "--" with spaces on both sides. Thanks for digging. I agree with that.