From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Arun Isaac Newsgroups: gmane.lisp.guile.user Subject: Re: How to write documentation comments for procedures? Date: Tue, 07 Aug 2018 11:28:03 +0530 Message-ID: References: <31082a15-b9f4-aba2-6a2b-2e784cf55406@gmail.com> <3ac96df4-1577-5912-ae9f-21e6ba7ef009@gmail.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1533621395 29434 195.159.176.226 (7 Aug 2018 05:56:35 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Tue, 7 Aug 2018 05:56:35 +0000 (UTC) To: Zelphir Kaltstahl , guile-user@gnu.org Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Tue Aug 07 07:56:31 2018 Return-path: Envelope-to: guile-user@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fmuys-0007Y6-5o for guile-user@m.gmane.org; Tue, 07 Aug 2018 07:56:30 +0200 Original-Received: from localhost ([::1]:37475 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fmv0y-0002pO-Q4 for guile-user@m.gmane.org; Tue, 07 Aug 2018 01:58:40 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39331) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fmv0Z-0002pJ-PM for guile-user@gnu.org; Tue, 07 Aug 2018 01:58:17 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fmv0Z-0006ev-38 for guile-user@gnu.org; Tue, 07 Aug 2018 01:58:15 -0400 Original-Received: from [2001:19f0:5:274f:351:616f:fec3:2694] (port=36064 helo=vultr.systemreboot.net) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fmv0Y-0006ed-NK for guile-user@gnu.org; Tue, 07 Aug 2018 01:58:15 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=systemreboot.net; s=default; h=Content-Type:MIME-Version:Message-ID:Date: References:In-Reply-To:Subject:To:From:Sender:Reply-To:Cc: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=EiLdin4ZE6GcvvDXbKRPAm+Vlu8iNrC7ti9CiT25CT4=; b=mccg+CimlbNvdDYGKn+fOOSmk KKF6w3J6adGDWXqxN7ocVbsnc/Wf8KYuDjpKUh5YzfYSJPwKxZyex8oP5WQP+/CoQ3b6vXfH96/UE RMJHjOsNfqOx71FxXAfu6XS7uKGmuPqAp6S6B86S8q8IEEG5lOkPJfgJJXfUUqzJa/fC4=; Original-Received: from [192.168.2.1] (helo=steel) by systemreboot.net with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.91) (envelope-from ) id 1fmv0T-0004pQ-LI; Tue, 07 Aug 2018 11:28:10 +0530 In-Reply-To: <3ac96df4-1577-5912-ae9f-21e6ba7ef009@gmail.com> X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2001:19f0:5:274f:351:616f:fec3:2694 X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane.org@gnu.org Original-Sender: "guile-user" Xref: news.gmane.org gmane.lisp.guile.user:14728 Archived-At: > It still makes the second and later lines not indented though > (starting at position 0, while the first line is indented, not > starting at 0). Looking at the guile source code, the lack of indentation in the second and later lines seems to be the convention. So, I don't think this is a problem. Something like the following is fine. (define (foo arg) "This is the first line. This is the second line." #t)