From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Jan (janneke) Nieuwenhuizen" Newsgroups: gmane.lisp.guile.bugs Subject: bug#43814: [PATCH] Document write-line. Date: Mon, 5 Oct 2020 15:52:59 +0200 Message-ID: <20201005135259.4652-1-janneke@gnu.org> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="10519"; mail-complaints-to="usenet@ciao.gmane.io" To: 43814@debbugs.gnu.org Original-X-From: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Mon Oct 05 15:54:08 2020 Return-path: Envelope-to: guile-bugs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1kPQwJ-0002ex-PK for guile-bugs@m.gmane-mx.org; Mon, 05 Oct 2020 15:54:07 +0200 Original-Received: from localhost ([::1]:49402 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kPQwI-0005T8-PU for guile-bugs@m.gmane-mx.org; Mon, 05 Oct 2020 09:54:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53394) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kPQwE-0005RL-Kb for bug-guile@gnu.org; Mon, 05 Oct 2020 09:54:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:36831) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kPQwE-0008QS-AR for bug-guile@gnu.org; Mon, 05 Oct 2020 09:54:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1kPQwE-0004bD-8u for bug-guile@gnu.org; Mon, 05 Oct 2020 09:54:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: "Jan (janneke) Nieuwenhuizen" Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Mon, 05 Oct 2020 13:54:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 43814 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch X-Debbugs-Original-To: bug-guile@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.160190598817614 (code B ref -1); Mon, 05 Oct 2020 13:54:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 5 Oct 2020 13:53:08 +0000 Original-Received: from localhost ([127.0.0.1]:48377 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kPQvM-0004a1-70 for submit@debbugs.gnu.org; Mon, 05 Oct 2020 09:53:08 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:35630) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1kPQvH-0004Zq-G6 for submit@debbugs.gnu.org; Mon, 05 Oct 2020 09:53:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:53228) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kPQvH-0004Ou-6b for bug-guile@gnu.org; Mon, 05 Oct 2020 09:53:03 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:59057) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1kPQvG-0008Md-Rp; Mon, 05 Oct 2020 09:53:02 -0400 Original-Received: from [2001:980:1b4f:1:42d2:832d:bb59:862] (port=36516 helo=dundal.fritz.box) by fencepost.gnu.org with esmtpa (Exim 4.82) (envelope-from ) id 1kPQvG-0001Xm-9p; Mon, 05 Oct 2020 09:53:02 -0400 X-Mailer: git-send-email 2.28.0 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Original-Sender: "bug-guile" Xref: news.gmane.io gmane.lisp.guile.bugs:9895 Archived-At: * libguile/rdelim.c (SCM_DEFINE): Use "procedure" rather than "function". * doc/ref/api-io.texi (Line/Delimited): Use it to document 'write-line'. --- doc/ref/api-io.texi | 11 +++++++++++ libguile/rdelim.c | 2 +- 2 files changed, 12 insertions(+), 1 deletion(-) diff --git a/doc/ref/api-io.texi b/doc/ref/api-io.texi index ecbd35585a..a1781dfd6a 100644 --- a/doc/ref/api-io.texi +++ b/doc/ref/api-io.texi @@ -829,6 +829,17 @@ delimiter may be either a newline or the @var{eof-object}; if @code{(# . #)}. @end deffn +@deffn {Scheme Procedure} write-line obj [port] +@deffnx {C Function} scm_write_line (obj, port) +Display @var{obj} and a newline character to @var{port}. If +@var{port} is not specified, @code{(current-output-port)} is +used. This procedure is equivalent to: +@lisp +(display obj [port]) +(newline [port]) +@end lisp +@end deffn + @node Default Ports @subsection Default Ports for Input, Output and Errors @cindex Default ports diff --git a/libguile/rdelim.c b/libguile/rdelim.c index 4a0b20954e..9d41712dd1 100644 --- a/libguile/rdelim.c +++ b/libguile/rdelim.c @@ -189,7 +189,7 @@ SCM_DEFINE (scm_write_line, "write-line", 1, 1, 0, (SCM obj, SCM port), "Display @var{obj} and a newline character to @var{port}. If\n" "@var{port} is not specified, @code{(current-output-port)} is\n" - "used. This function is equivalent to:\n" + "used. This procedure is equivalent to:\n" "@lisp\n" "(display obj [port])\n" "(newline [port])\n" -- Jan Nieuwenhuizen | GNU LilyPond http://lilypond.org Freelance IT http://JoyofSource.com | AvatarĀ® http://AvatarAcademy.com