From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nils Gillmann Subject: Re: [doc RFC] Tame the Guix profile blizzard? Date: Wed, 11 Jul 2018 08:06:03 +0000 Message-ID: <20180711080603.ipneixoo4k4icuad@abyayala> References: <87tvp8q8pj.fsf@gmail.com> <20180710085426.nl3mzzbv7clkszm4@abyayala> <87zhyy4fuz.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:50284) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fdA7u-0007he-0Q for guix-devel@gnu.org; Wed, 11 Jul 2018 04:05:31 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fdA7p-00037E-IM for guix-devel@gnu.org; Wed, 11 Jul 2018 04:05:29 -0400 Received: from static.195.114.201.195.clients.your-server.de ([195.201.114.195]:54018 helo=conspiracy.of.n0.is) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fdA7p-000351-2m for guix-devel@gnu.org; Wed, 11 Jul 2018 04:05:25 -0400 Content-Disposition: inline In-Reply-To: <87zhyy4fuz.fsf@gmail.com> 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+gcggd-guix-devel=m.gmane.org@gnu.org Sender: "Guix-devel" To: George Clemmer Cc: guix-devel , Nils Gillmann George Clemmer transcribed 733 bytes: > Hi Nils, > > Nils Gillmann writes: > > > 4) before each profile kind is used for the first time, > > make use of something like this for the brief introduction > > of it again (our manual is not very long, but it is still > > long): > > I Agee. > > > @cartouche > > @quotation Note > > In the following ``spacejump'' refers to … > > @end quotation > > @end cartouche > > > > this renders at least in HTML and PDF output of texinfo. I haven't > > used this very much so far. > > > > A visual example can be found in 'Exchange', Chapter 'Configuration' > > in https://docs.taler.net/ > > I assume you refer to the box that reads, "Note: The rationale behind > having multiple bank accounts ..." and I agreed this would work well. yes. > - George >