From patchwork Thu Nov 30 10:28:58 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yaakov Selkowitz X-Patchwork-Id: 120114 Delivered-To: patch@linaro.org Received: by 10.140.22.227 with SMTP id 90csp487491qgn; Thu, 30 Nov 2017 02:31:10 -0800 (PST) X-Google-Smtp-Source: AGs4zMYz/7AyoL5ByugFqSwG9U3cYqEr0TcwcFPUbn7JyMGTwWWl9qC52yRv2XL4GuuQsxQaJm+Q X-Received: by 10.99.141.75 with SMTP id z72mr1899243pgd.73.1512037870862; Thu, 30 Nov 2017 02:31:10 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1512037870; cv=none; d=google.com; s=arc-20160816; b=khJ6LcsVI6cDztxUguxt4jTow1riXqTqrzSe3kXVA1jNylgExSR0NMk1zkY9d02FpR G6qfpUvyHT7nJxbTtq5b/fF1KztwmZ1stk0VICaynoCoQ7yecNMr17lYOrxObG85pGk9 oVLaouQ5imYWSpa2EkCNaBTRLdBCV2yXZXkX2AOjr6yFDDwtwI/yj1A0nxzSWw0ByTzY Yy9QCxSbvhtDEoan9E8qbcEYH3mNiczdBDOlllpIO+ylXEtVX8tsXtpQB+RuKkxH1j/O JQPVe6bquJX9pye3EvdNvL036cnUaB6GzyfDhNqHyQoaAd9YgwnObuP0nkdoRXHm+4fG /5ag== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=references:in-reply-to:message-id:date:subject:to:from:delivered-to :sender:list-help:list-post:list-archive:list-subscribe :list-unsubscribe:list-id:precedence:mailing-list:dkim-signature :domainkey-signature:arc-authentication-results; bh=y6PBpGguSLAiHm5LU68GPgky+UNz2fhAro+ywbZQYuI=; b=hFwbQIb65YUincE0hlYtOCIX6GhRzKh2NSB/ARkRuaXZr47H6QvjfERi6RGQrMv3Xa q7gSasnGvnMdaJpxc6jaoqABIKy79LqOe/yPKqkEYzmNhp9sVBmUuJ3br2+0W68lyGar ZBPP+uxcJVhOyfio/NJe+rKXlcpWYHZN9YsjsxalhH7XWuszzMK6468zxaOd/mNd2PCW FSzTUAixV2B8kV5+Cr86jfi83yQVB3r2iFvFYCWgEoS21jSxBB/A70AOSYnNLb7GpjhZ hw+Fyz1ZJcT4/fN7c0RyCdlC33eQhxEaQhEgKFpH8iRx/XN+z6fOfXkL2bM94ixwE/Va HIyQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@sourceware.org header.s=default header.b=qL22zvWz; spf=pass (google.com: domain of newlib-return-15429-patch=linaro.org@sourceware.org designates 209.132.180.131 as permitted sender) smtp.mailfrom=newlib-return-15429-patch=linaro.org@sourceware.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from sourceware.org (server1.sourceware.org. [209.132.180.131]) by mx.google.com with ESMTPS id y84si2994796pfa.362.2017.11.30.02.31.10 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Thu, 30 Nov 2017 02:31:10 -0800 (PST) Received-SPF: pass (google.com: domain of newlib-return-15429-patch=linaro.org@sourceware.org designates 209.132.180.131 as permitted sender) client-ip=209.132.180.131; Authentication-Results: mx.google.com; dkim=pass header.i=@sourceware.org header.s=default header.b=qL22zvWz; spf=pass (google.com: domain of newlib-return-15429-patch=linaro.org@sourceware.org designates 209.132.180.131 as permitted sender) smtp.mailfrom=newlib-return-15429-patch=linaro.org@sourceware.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=redhat.com DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:subject:date:message-id:in-reply-to :references; q=dns; s=default; b=aJCJDdIcLz61fsw3REiWbwxekIZ1JJo QAURLzPYBj2yyuQuK+VWA6RqMiKh2Eii7OPJNYxhnrR9eEujbsmow0rBxZmcZBqS T3EtJu0D+FyMHSE6bku5dTpEAORppCS9y8bX/zWevPIJg/SsrytW7/jmcTcWqQ2s aitle8eBrd0c= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=sourceware.org; h=list-id :list-unsubscribe:list-subscribe:list-archive:list-post :list-help:sender:from:to:subject:date:message-id:in-reply-to :references; s=default; bh=E1X1mgxr0ichxoW0IDyM/bHW92M=; b=qL22z vWzYrnV/zAb7DxYD9Tr7UkK63EBgdHEkrZ9t6CnmJb9ZG7PqF69RNHGkoXkBd2u3 TC76Wy/r0DR3vQtGBk33VPJQWY5n3jHsYKMk7kt6SqjAcitPMKrfWvvIizAA5k6Q BXJLtH7auBqVq1ws/4RE/YfdWB69tz5eK7F2ug= Received: (qmail 86326 invoked by alias); 30 Nov 2017 10:29:29 -0000 Mailing-List: contact newlib-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: newlib-owner@sourceware.org Delivered-To: mailing list newlib@sourceware.org Received: (qmail 86273 invoked by uid 89); 30 Nov 2017 10:29:29 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-26.7 required=5.0 tests=BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, KB_WAM_FROM_NAME_SINGLEWORD, SPF_HELO_PASS, T_RP_MATCHES_RCVD autolearn=ham version=3.3.2 spammy= X-HELO: mx1.redhat.com Received: from mx1.redhat.com (HELO mx1.redhat.com) (209.132.183.28) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 30 Nov 2017 10:29:28 +0000 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 143F9C058EAF for ; Thu, 30 Nov 2017 10:29:20 +0000 (UTC) Received: from localhost.localdomain (ovpn-116-45.phx2.redhat.com [10.3.116.45]) by smtp.corp.redhat.com (Postfix) with ESMTPS id C73374DA0B for ; Thu, 30 Nov 2017 10:29:19 +0000 (UTC) From: Yaakov Selkowitz To: newlib@sourceware.org Subject: [PATCH 24/24] HOWTO: remove reference to TRAD_SYNOPSIS Date: Thu, 30 Nov 2017 04:28:58 -0600 Message-Id: <20171130102858.16160-25-yselkowi@redhat.com> In-Reply-To: <20171130102858.16160-1-yselkowi@redhat.com> References: <20171130102858.16160-1-yselkowi@redhat.com> Signed-off-by: Yaakov Selkowitz --- newlib/HOWTO | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) -- 2.15.0 diff --git a/newlib/HOWTO b/newlib/HOWTO index c5754e5b8..bb49e79dd 100644 --- a/newlib/HOWTO +++ b/newlib/HOWTO @@ -47,14 +47,8 @@ but these, however, should be carefully limited and be given alternates for when a non-printed manual is produced--such as when info pages are produced. For an example of this kind of usage, see libm/common/s_logb.c. - Please note that most files with documentation contain both an -ANSI_SYNOPSIS and a TRAD_SYNOPSIS section. The TRAD_SYNOPSIS section gets -deleted (since at least 2000) by makedoc, so when working on files these -can safely be deleted and if you're making a new file, there is no need -to add the TRAD_SYNOPSIS section. - If writing a new function that requires documentation, the required -sections are FUNCTION, INDEX, ANSI_SYNOPSIS (or SYNOPSIS), DESCRIPTION, RETURNS, +sections are FUNCTION, INDEX, SYNOPSIS, DESCRIPTION, RETURNS, and PORTABILITY. BUGS and SEEALSO should be added as appropriate. Source files which contain documentation are processed into ".def"