From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from azure-sdnproxy.icoremail.net (azure-sdnproxy.icoremail.net [207.46.229.174]) by sourceware.org (Postfix) with ESMTP id 198823858D38 for ; Thu, 16 Mar 2023 02:59:51 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 198823858D38 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=eswincomputing.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=eswincomputing.com Received: from host039-ubuntu-1804.lxd (unknown [10.12.130.38]) by app1 (Coremail) with SMTP id EwgMCgBn0pUlhhJkMoUGAA--.34817S4; Thu, 16 Mar 2023 10:59:49 +0800 (CST) From: Songhe Zhu To: newlib@sourceware.org Cc: gaofei@eswincomputing.com, wangfeng@eswincomputing.com, Songhe Zhu Subject: [PATCH] Cygwin: doc: Fix type mismatch in porting.texi Date: Thu, 16 Mar 2023 10:59:47 +0800 Message-Id: <20230316025947.63497-1-zhusonghe@eswincomputing.com> X-Mailer: git-send-email 2.17.1 X-CM-TRANSID:EwgMCgBn0pUlhhJkMoUGAA--.34817S4 X-Coremail-Antispam: 1UD129KBjvJXoW7uw4rGw1DZFW7tFyDCw4UJwb_yoW8Kw1xpa 1Ig3WrWr45KFykZwn5uwna9ry8CF4vka1UJrWDuryjv3WYqa4qgryaya43Zr45XFs3urn3 XFW0qFWxZw1fXaDanT9S1TB71UUUUUUqnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDU0xBIdaVrnRJUUUkI14x267AKxVWUJVW8JwAFc2x0x2IEx4CE42xK8VAvwI8IcIk0 rVWrJVCq3wAFIxvE14AKwVWUJVWUGwA2ocxC64kIII0Yj41l84x0c7CEw4AK67xGY2AK02 1l84ACjcxK6xIIjxv20xvE14v26w1j6s0DM28EF7xvwVC0I7IYx2IY6xkF7I0E14v26r4U JVWxJr1l84ACjcxK6I8E87Iv67AKxVW0oVCq3wA2z4x0Y4vEx4A2jsIEc7CjxVAFwI0_Gc CE3s1le2I262IYc4CY6c8Ij28IcVAaY2xG8wAqx4xG64xvF2IEw4CE5I8CrVC2j2WlYx0E 2Ix0cI8IcVAFwI0_Jr0_Jr4lYx0Ex4A2jsIE14v26r1j6r4UMcvjeVCFs4IE7xkEbVWUJV W8JwACjcxG0xvY0x0EwIxGrwACjI8F5VA0II8E6IAqYI8I648v4I1lc2xSY4AK6svPMxAI w28IcxkI7VAKI48JMxC20s026xCaFVCjc4AY6r1j6r4UMI8I3I0E5I8CrVAFwI0_Jr0_Jr 4lx2IqxVCjr7xvwVAFwI0_JrI_JrWlx4CE17CEb7AF67AKxVWUAVWUtwCIc40Y0x0EwIxG rwCI42IY6xIIjxv20xvE14v26r1j6r1xMIIF0xvE2Ix0cI8IcVCY1x0267AKxVWUJVW8Jw CI42IY6xAIw20EY4v20xvaj40_Jr0_JF4lIxAIcVC2z280aVAFwI0_Jr0_Gr1lIxAIcVC2 z280aVCY1x0267AKxVW8JVW8JrUvcSsGvfC2KfnxnUUI43ZEXa7VUbrMaUUUUUU== X-CM-SenderInfo: 52kx20pqjkvqphvzx0xfrp13pwlqwhhfrp/ X-Spam-Status: No, score=-12.7 required=5.0 tests=BAYES_00,GIT_PATCH_0,KAM_DMARC_STATUS,KAM_SHORT,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: Issue:newlib/libgloss/doc/porting.texi:570: warning: @ref node name should not contain `.' newlib/libgloss/doc/porting.texi:747: warning: @ref node name should not contain `.' newlib/libgloss/doc/porting.texi:938: warning: @ref node name should not contain `.' reproduce: git clone https://github.com/riscv-collab/riscv-gnu-toolchain.git cd riscv-gnu-toolchain ./configure --prefix=`pwd`/install --with-arch=rv64gc --with-abi=lp64d --enable-multilib make -j $(nproc) The above issue will happen when executing the build command. This patch eliminates these warnings. @ref{That},'That' does not contain node; I think it's just appropriate to use @file here, @file{file-name},'file-name' support node; refer:https://www.gnu.org/software/texinfo/manual/texinfo/texinfo.html#g_t_0040file --- libgloss/doc/porting.texi | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/libgloss/doc/porting.texi b/libgloss/doc/porting.texi index 15f214d02..4a269a970 100644 --- a/libgloss/doc/porting.texi +++ b/libgloss/doc/porting.texi @@ -567,7 +567,7 @@ and then the ROM takes over. Pick a safe vector with no side effects. Some ROMs have a builtin trap handler just for this case. @end enumerate portable between all the m68k based boards we have here. -@ref{crt0.S,,Example Crt0.S}. +@file{crt0.S,,Example Crt0.S}. @smallexample @@ -744,7 +744,7 @@ check a few critical addresses like @code{start}, @code{bss_end}, and Here's a breakdown of a linker script for a m68k based target board. See the file @code{libgloss/m68k/idp.ld}, or go to the appendixes in -the end of the manual. @ref{idp.ld,,Example Linker Script}. +the end of the manual. @file{idp.ld,,Example Linker Script}. @smallexample STARTUP(crt0.o) @@ -935,7 +935,7 @@ sbrk(). @code{malloc()}, @code{calloc()}, and @code{realloc()} all call @code{sbrk()} at there lowest level. @code{caddr_t} is defined elsewhere as @code{char *}. @code{RAMSIZE} is presently a compile time option. All this does is move a pointer to heap memory and check for the upper -limit. @ref{glue.c,,Example libc support code}. @code{sbrk()} returns a +limit. @file{glue.c,,Example libc support code}. @code{sbrk()} returns a pointer to the previous value before more memory was allocated. @smallexample -- 2.17.1