From patchwork Tue Oct 29 10:39:02 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Chung-Ju Wu X-Patchwork-Id: 286781 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]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id B31352C0343 for ; Tue, 29 Oct 2013 21:39:11 +1100 (EST) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender :mime-version:date:message-id:subject:from:to:content-type; q= dns; s=default; b=e04d4G0gsNtjNwrZn1OI/HdNBaTymM21gnJRl93lgl9QGI LE82uVNJYVuoxFxz/aAYmMnc9a82LXFWFSpDJn95Nf00YBdOlR55YcDeHPaGGJaB gNnY/urSygnO26YQclbNwpTDyXK32ay6wbNQRgAO68330OMvJEswmTJ5R0cmI= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender :mime-version:date:message-id:subject:from:to:content-type; s= default; bh=kK3+ujtLHggNVbw0ohavIau0SNM=; b=LdBgs4rotab8Qd0HHfsq urQHM3j/9tK/p272xRrot013tU5mqDtPkD1GjYDorj5j5JJ3Ap2qezwuUVnZfgpl goKSFtQkIg9RC4UL3AYhL3DLfhG3aHwQbCv7d7OVVrJTmQY5+yJGp4kgu0VcIhau 6/5lYVh8d1RWB3LoTPZriyA= Received: (qmail 10602 invoked by alias); 29 Oct 2013 10:39:05 -0000 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 Received: (qmail 10589 invoked by uid 89); 29 Oct 2013 10:39:04 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-0.8 required=5.0 tests=AWL, BAYES_05, FREEMAIL_FROM, RCVD_IN_DNSWL_NONE, SPF_PASS autolearn=ham version=3.3.2 X-HELO: mail-pd0-f179.google.com Received: from mail-pd0-f179.google.com (HELO mail-pd0-f179.google.com) (209.85.192.179) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES128-SHA encrypted) ESMTPS; Tue, 29 Oct 2013 10:39:04 +0000 Received: by mail-pd0-f179.google.com with SMTP id y10so8436836pdj.10 for ; Tue, 29 Oct 2013 03:39:02 -0700 (PDT) MIME-Version: 1.0 X-Received: by 10.67.23.164 with SMTP id ib4mr30569428pad.42.1383043142304; Tue, 29 Oct 2013 03:39:02 -0700 (PDT) Received: by 10.68.149.129 with HTTP; Tue, 29 Oct 2013 03:39:02 -0700 (PDT) Date: Tue, 29 Oct 2013 18:39:02 +0800 Message-ID: Subject: [PATCH v4, nds32] Andes nds32 port, documentation part From: Chung-Ju Wu To: gcc patches X-IsSubscribed: yes This is v4 patch for Andes nds32 port on documentation part. Thanks Joseph Myers's comments. Now we use @deftypefn and @samp to refine our documentation content. The diff is as follows and the patch file is attached. @item --with-build-time-tools=@var{dir} gcc/ 2013-10-29 Chung-Ju Wu Shiva Chen * doc/invoke.texi (NDS32 options): Document nds32 specific options. * doc/md.texi (NDS32 family): Document nds32 specific constraints. * doc/install.texi (Cross-Compiler-Specific Options): Document --with-nds32-lib for nds32 target. * doc/extend.texi (Function Attributes): Document nds32 specific attributes. Best regards, jasonwucj diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index f0002a9..5f91813 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -12432,33 +12432,38 @@ once the handler returns. These built-in functions are available for the NDS32 target: -@table @code -@item void __builtin_nds32_isync (int *@var{addr}) +@deftypefn {Built-in Function} void __builtin_nds32_isync (int *@var{addr}) Insert an ISYNC instruction into the instruction stream where @var{addr} is an instruction address for serialization. +@end deftypefn -@item void __builtin_nds32_isb (void) +@deftypefn {Built-in Function} void __builtin_nds32_isb (void) Insert an ISB instruction into the instruction stream. +@end deftypefn -@item int __builtin_nds32_mfsr (int @var{sr}) +@deftypefn {Built-in Function} int __builtin_nds32_mfsr (int @var{sr}) Return the content of a system register which is mapped by @var{sr}. +@end deftypefn -@item int __builtin_nds32_mfusr (int @var{usr}) +@deftypefn {Built-in Function} int __builtin_nds32_mfusr (int @var{usr}) Return the content of a user space register which is mapped by @var{usr}. +@end deftypefn -@item void __builtin_nds32_mtsr (int @var{value}, int @var{sr}) +@deftypefn {Built-in Function} void __builtin_nds32_mtsr (int @var{value}, int @var{sr}) Move the @var{value} to a system register which is mapped by @var{sr}. +@end deftypefn -@item void __builtin_nds32_mtusr (int @var{value}, int @var{usr}) +@deftypefn {Built-in Function} void __builtin_nds32_mtusr (int @var{value}, int @var{usr}) Move the @var{value} to a user space register which is mapped by @var{usr}. +@end deftypefn -@item void __builtin_nds32_setgie_en (void) +@deftypefn {Built-in Function} void __builtin_nds32_setgie_en (void) Enable global interrupt. +@end deftypefn -@item void __builtin_nds32_setgie_dis (void) +@deftypefn {Built-in Function} void __builtin_nds32_setgie_dis (void) Disable global interrupt. - -@end table +@end deftypefn @node picoChip Built-in Functions @subsection picoChip Built-in Functions diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index 68af98e..cbc0644 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -1864,7 +1864,7 @@ supported since version 4.7.2 and is the default in 4.8.0 and newer. @item --with-nds32-lib=@var{library} Specifies that @var{library} setting is used for building @file{libgcc.a}. -Currently, the valid @var{library} is 'newlib' or 'mculib'. +Currently, the valid @var{library} is @samp{newlib} or @samp{mculib}. This option is only supported for the NDS32 target.