From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Zelphir Kaltstahl Newsgroups: gmane.lisp.guile.user Subject: Re: How to write documentation comments for procedures? Date: Tue, 7 Aug 2018 00:58:08 +0200 Message-ID: <3ac96df4-1577-5912-ae9f-21e6ba7ef009@gmail.com> References: <31082a15-b9f4-aba2-6a2b-2e784cf55406@gmail.com> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: blaine.gmane.org 1533596192 9552 195.159.176.226 (6 Aug 2018 22:56:32 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Mon, 6 Aug 2018 22:56:32 +0000 (UTC) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1 To: Arun Isaac , guile-user@gnu.org Original-X-From: guile-user-bounces+guile-user=m.gmane.org@gnu.org Tue Aug 07 00:56:28 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 1fmoQM-0002Kh-4T for guile-user@m.gmane.org; Tue, 07 Aug 2018 00:56:26 +0200 Original-Received: from localhost ([::1]:36587 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fmoSS-0005eC-Rq for guile-user@m.gmane.org; Mon, 06 Aug 2018 18:58:36 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:54087) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fmoS5-0005e6-Ki for guile-user@gnu.org; Mon, 06 Aug 2018 18:58:14 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fmoS4-0008W4-KR for guile-user@gnu.org; Mon, 06 Aug 2018 18:58:13 -0400 Original-Received: from mail-ed1-x52a.google.com ([2a00:1450:4864:20::52a]:42908) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fmoS4-0008VM-Dw for guile-user@gnu.org; Mon, 06 Aug 2018 18:58:12 -0400 Original-Received: by mail-ed1-x52a.google.com with SMTP id r4-v6so5970851edp.9 for ; Mon, 06 Aug 2018 15:58:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-transfer-encoding:content-language; bh=+YBcDmtFtZ1S97U3IVNHHx7B3eDsz3OIMXzeAfezOJE=; b=UQ6B79sNOC3JG8vMYfE+pv0/lIycpKsBb6Hg9EE4d2r2BxzklMgRvuIiq4vTDtqK05 7JH3Fk2BsIfAssW+9SYqlwf/2uTNBfPE3nF5sjWGWDmsXSGtELLDmlDymGDk5bBKO7K2 gq/H47SLtbgCEoPR27JFB+pzKbY0hWuIZCalNe7m8bBtUSvffuGeWSDyhqvU0Ll2GFQf CpbBEhD5Qw9DGe1K0ZIQLDkPZK15GnMliUfygfvNHnzd62DNeZT1CE6r33jXvSBupFUq rnu8AyzL0jH4eSHharOzS7DUZqyEpVKPG5sdhroU++/8NJc/IuaRzDSWCeoQ3YkxoN8t bZwg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=+YBcDmtFtZ1S97U3IVNHHx7B3eDsz3OIMXzeAfezOJE=; b=bWGpUDXhhA1Wa61apkP59NmoyhvGV9IenVsRCCzLUgAWwUDsDSmmBXa7jjqRJ83ptm bAMpjDRm6lCG1js9KyK8mQ8FgwohOtzjFHJIl0FYQcixHvwrxZXJ/vSeDtu2oZW5bc3v arVPom96mHkDRhRTQxkYzefuxmXo9NVxw0YFhHI5iSHtnKaepOc58pjOn4M74sUpboMU 9aRU8dohtoxEaSQvm1lLTNP2bf1Z41Ku5loGFjN8KS4vqsI3xWZhFU8EiiacqEpwPrQo IgITs6jyLlQr1JI5OZJO+akTVpu+aJHYz1agRq7mQhxPqoxTKxtI/2bB7PL0f6mQTUZl Szgg== X-Gm-Message-State: AOUpUlHvZO8ab+UVwnspcoBAq9mLe5acbYoXjzKTwUJ+Jjj/jHrK9Oul 4iC7BnxzJkjt5fhx2PZJ1aMzxgKW X-Google-Smtp-Source: AAOMgpe6CfPsmlY4/9weHUJvuPEr8PIUORjMIyuH8a8UndwqtC5jzs3tfXmLqmK0i/z82Y7cWjJzEQ== X-Received: by 2002:a50:97bb:: with SMTP id e56-v6mr20199691edb.58.1533596290422; Mon, 06 Aug 2018 15:58:10 -0700 (PDT) Original-Received: from ?IPv6:2a02:8109:ad3f:ec78:7168:d83c:64ca:8145? ([2a02:8109:ad3f:ec78:7168:d83c:64ca:8145]) by smtp.googlemail.com with ESMTPSA id w3-v6sm11491edb.16.2018.08.06.15.58.09 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 06 Aug 2018 15:58:09 -0700 (PDT) In-Reply-To: Content-Language: en-US X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::52a 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:14727 Archived-At: Ha, I did not know that one. 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). Anyway, knowing this shortcut would have saved me soooo much time in many cases … Thanks. On 06.08.2018 11:26, Arun Isaac wrote: >> However, when I have a longer explanation for a procedure, longer than a >> single line of certain length, then the line will softly wrap in editors >> and the explanation will continue on the next line at the beginning >> usually. > In emacs, I find `fill-paragraph' (default keybinding of M-q) to be very > useful for wrapping long lines.