From patchwork Tue Nov 20 11:44:48 2012 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jonathan Wakely X-Patchwork-Id: 200308 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) by ozlabs.org (Postfix) with SMTP id 6B9452C0087 for ; Tue, 20 Nov 2012 22:45:14 +1100 (EST) Comment: DKIM? See http://www.dkim.org DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=gcc.gnu.org; s=default; x=1354016715; h=Comment: DomainKey-Signature:Received:Received:Received:Received: MIME-Version:Received:Received:In-Reply-To:References:Date: Message-ID:Subject:From:To:Cc:Content-Type:Mailing-List: Precedence:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:Sender:Delivered-To; bh=/9Chufg4VuuRUjTewi1GBG/3rME=; b=h6bUWH1nxEBdQCgJjUyNw5vwl4KhJVcqPUNyYPcR4PTbjqhbA733EwU7VVGLrk 1w8p1ZuW7cVlhbGB98lkHTkanQSU6piQgkrymmNmLsiUJwDKQsmXgelfrLMkhCE5 L3veyimkVaCmOb4de/ZBcu4QxdG6chXLrOGeuBzwYff6Y= Comment: DomainKeys? See http://antispam.yahoo.com/domainkeys DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=default; d=gcc.gnu.org; h=Received:Received:X-SWARE-Spam-Status:X-Spam-Check-By:Received:Received:MIME-Version:Received:Received:In-Reply-To:References:Date:Message-ID:Subject:From:To:Cc:Content-Type:Mailing-List:Precedence:List-Id:List-Unsubscribe:List-Archive:List-Post:List-Help:Sender:Delivered-To; b=nqTahKxbbXTFSbP++iw00OadNGPAugRdamS/q8erpXoDqeKMPAYvy7cWqYAWKT ZyjJpw/FdhUsLWQo+MkFL645VeQKwbAV7tU5v9XNKXeC7NL+rFLgn5eK0PYPXEZu +/Ex7LpcloUlorNuD9IakcwvPFdhwXj3fuI92I8cdFW0s=; Received: (qmail 20742 invoked by alias); 20 Nov 2012 11:44:55 -0000 Received: (qmail 20724 invoked by uid 22791); 20 Nov 2012 11:44:55 -0000 X-SWARE-Spam-Status: No, hits=-5.2 required=5.0 tests=AWL, BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, FREEMAIL_FROM, KHOP_RCVD_TRUST, KHOP_THREADED, RCVD_IN_DNSWL_LOW, RCVD_IN_HOSTKARMA_YE X-Spam-Check-By: sourceware.org Received: from mail-ie0-f175.google.com (HELO mail-ie0-f175.google.com) (209.85.223.175) by sourceware.org (qpsmtpd/0.43rc1) with ESMTP; Tue, 20 Nov 2012 11:44:49 +0000 Received: by mail-ie0-f175.google.com with SMTP id qd14so2922096ieb.20 for ; Tue, 20 Nov 2012 03:44:49 -0800 (PST) MIME-Version: 1.0 Received: by 10.50.203.100 with SMTP id kp4mr9585136igc.35.1353411889097; Tue, 20 Nov 2012 03:44:49 -0800 (PST) Received: by 10.42.158.202 with HTTP; Tue, 20 Nov 2012 03:44:48 -0800 (PST) In-Reply-To: <50A913E3.4060008@ubuntu.com> References: <50A913E3.4060008@ubuntu.com> Date: Tue, 20 Nov 2012 11:44:48 +0000 Message-ID: Subject: Re: [patch] escape sharp brackets to avoid doxygen warnings From: Jonathan Wakely To: Matthias Klose Cc: "libstdc++@gcc.gnu.org" , gcc-patches Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org On 18 November 2012 16:59, Matthias Klose wrote: > currently doxygen complains about unknown xml/html tags. this patch properly(?) > escapes these. Maybe this is a change in doxygen 1.8, it didn't seem to be > necessary in the past. Ok for the trunk? (Added gcc-patches to the CC list) OK, thanks. 2012-11-18 Matthias Klose * doc/doxygen/user.cfg.in (ALIASES). Escape sharp braces. * include/bits/allocator.h: Escape sharp braces in comment. * include/profile/impl/profiler_algos.h: Likewise. Index: doc/doxygen/user.cfg.in =================================================================== --- doc/doxygen/user.cfg.in (revision 193528) +++ doc/doxygen/user.cfg.in (working copy) @@ -196,8 +196,8 @@ # You can put \n's in the value part of an alias to insert newlines. ALIASES = "doctodo=@todo\nNeeds documentation! See http://gcc.gnu.org/onlinedocs/libstdc++/manual/documentation_style.html" \ - "headername{1}=Instead, include <\1>." \ - "headername{2}=Instead, include <\1> or <\2>." + "headername{1}=Instead, include \<\1\>." \ + "headername{2}=Instead, include \<\1\> or \<\2\>." # This tag can be used to specify a number of word-keyword mappings (TCL only). # A mapping has the form "name=value". For example adding Index: include/profile/impl/profiler_algos.h =================================================================== --- include/profile/impl/profiler_algos.h (revision 193528) +++ include/profile/impl/profiler_algos.h (working copy) @@ -24,7 +24,7 @@ /** @file profile/impl/profiler_algos.h * @brief Algorithms used by the profile extension. * - * This file is needed to avoid including or . + * This file is needed to avoid including \ or \. * Including those files would result in recursive includes. * These implementations are oversimplified. In general, efficiency may be * sacrificed to minimize maintenance overhead. Index: include/bits/allocator.h =================================================================== --- include/bits/allocator.h (revision 193528) +++ include/bits/allocator.h (working copy) @@ -136,7 +136,7 @@ operator!=(const allocator<_Tp>&, const allocator<_Tp>&) { return false; } - /// Declare uses_allocator so it can be specialized in etc. + /// Declare uses_allocator so it can be specialized in \ etc. template struct uses_allocator;