From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id cI9zKEOK2l6TJQAA0tVLHw (envelope-from ) for ; Fri, 05 Jun 2020 18:09:07 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id yKBjJEOK2l4cDgAAB5/wlQ (envelope-from ) for ; Fri, 05 Jun 2020 18:09:07 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 6B9689400B1 for ; Fri, 5 Jun 2020 18:09:07 +0000 (UTC) Received: from localhost ([::1]:60058 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jhGmA-0001oC-Dx for larch@yhetil.org; Fri, 05 Jun 2020 14:09:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:51092) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jhGgl-0003lo-Tj for guix-devel@gnu.org; Fri, 05 Jun 2020 14:03:31 -0400 Received: from lepiller.eu ([2a00:5884:8208::1]:44436) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jhGgk-0001G0-75; Fri, 05 Jun 2020 14:03:31 -0400 Received: from lepiller.eu (localhost [127.0.0.1]) by lepiller.eu (OpenSMTPD) with ESMTP id e6f02db2; Fri, 5 Jun 2020 18:03:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=lepiller.eu; h=date :in-reply-to:references:mime-version:content-type :content-transfer-encoding:subject:to:from:message-id; s=dkim; bh=V56Ji5gN8cArb6swXyL64NNS0X83EUxxrFNIH7hMOyM=; b=bsLAnpIDH53n PbT3aY0pcuKInZ9fSqNB7OGvV6IQ/YaYz0YmYAQJcMEEDN8kFHjo8ZOcPqC5gT2N 70jP0AQYhmtotVNmSMMEYFK/uHeKfYcnWIzX9Vv8i28nGK6ghEUn4YtVVkzCvTqL RN8T7dbwV9KvuFIRev3K14rDXIu8XDt9nWzgxBwwFGShKTEPbzhFCS8TzwRWfPRc 74dwU3sxpF0wx017D2sxrs4GtllY1SXy0SQp4lFVfnEgh/3Q3xSY2uTMruBl7A4K TjwuJLhwFRb7NkhnO74DQ6+4QYWe7XlKcGljkkEYhZVmk4QJEIxBm8qa1JJAaF7O 6ZhRIu4nhA== Received: by lepiller.eu (OpenSMTPD) with ESMTPSA id b6343a76 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO); Fri, 5 Jun 2020 18:03:08 +0000 (UTC) Date: Fri, 05 Jun 2020 14:02:57 -0400 User-Agent: K-9 Mail for Android In-Reply-To: References: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Subject: Re: Manual consistency To: guix-devel@gnu.org, zimoun , =?ISO-8859-1?Q?Ludovic_Court=E8s?= , Konrad Hinsen From: Julien Lepiller Message-ID: <703B1E0F-BE41-469D-9357-D3FFAA5CF8FD@lepiller.eu> Received-SPF: none client-ip=2a00:5884:8208::1; envelope-from=julien@lepiller.eu; helo=lepiller.eu X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: "Guix-devel" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=fail (rsa verify failed) header.d=lepiller.eu header.s=dkim header.b=bsLAnpID; dmarc=fail reason="SPF not aligned (relaxed)" header.from=lepiller.eu (policy=none); spf=pass (aspmx1.migadu.com: domain of guix-devel-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-devel-bounces@gnu.org X-Spam-Score: 0.09 X-TUID: /v5dgEG2DVO7 Le 5 juin 2020 13:34:57 GMT-04:00, zimoun a = =C3=A9crit : >Hi Ludo, > >(from: http://issues=2Eguix=2Egnu=2Eorg/issue/41253#10) > >On Fri, 5 Jun 2020 at 18:36, Ludovic Court=C3=A8s wrote: > >> > There are many examples in guix=2Etexi with $, and also many without= =2E >Plus >> > some with # as the command line prompt=2E >> >> Yeah, the manual is kinda inconsistent, and I=E2=80=99m self-inconsiste= nt to >> tell the truth=2E :-) >> >> I=E2=80=99ve come to the conclusion that snippets that contain only inp= ut >should >> be written without a prompt, for easier copy/pasting=2E >> >> (I=E2=80=99ve seen Python documentation where JS magic allows people to >toggle >> prompt display, I find it nice=2E) > >I propose to do a pass on that: > - apply this rule: no-$ for only input and $ to distinguish between >inputs and outputs=2E > - backtick ` replaced by $(=2E=2E=2E) as discussed elsewhere >and then send a "Fix typo" patch=2E And maybe add a bullet in the >Contributing Section=2E > >WDYT? > >All the best, >simon If there is a way to mark a sentence to wrap it into a class, we could als= o do some CSS magic with :before=2E That will allow us to show the prompt w= hile making it non-selectable I think, which is nice visually and for copy-= pasting=2E I'm not a texinfo guru though, so I don't know if it is feasible= =2E