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 NgQMFUFqHF8LIAAA0tVLHw (envelope-from ) for ; Sat, 25 Jul 2020 17:22:09 +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 sEVZEEFqHF/1QQAAB5/wlQ (envelope-from ) for ; Sat, 25 Jul 2020 17:22:09 +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 81C83940390 for ; Sat, 25 Jul 2020 17:22:08 +0000 (UTC) Received: from localhost ([::1]:45644 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jzNs6-0001xA-5n for larch@yhetil.org; Sat, 25 Jul 2020 13:22:06 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:44766) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jzNs2-0001wn-JC for guix-patches@gnu.org; Sat, 25 Jul 2020 13:22:02 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:39510) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jzNs2-0004w1-80 for guix-patches@gnu.org; Sat, 25 Jul 2020 13:22:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jzNs2-0006ee-4k for guix-patches@gnu.org; Sat, 25 Jul 2020 13:22:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#42516] [PATCH] doc: Extend tlp-service-type example. Resent-From: Marius Bakke Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sat, 25 Jul 2020 17:22:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 42516 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Brett Gilio , Tobias Geerinckx-Rice Cc: 42516@debbugs.gnu.org Received: via spool by 42516-submit@debbugs.gnu.org id=B42516.159569770025551 (code B ref 42516); Sat, 25 Jul 2020 17:22:02 +0000 Received: (at 42516) by debbugs.gnu.org; 25 Jul 2020 17:21:40 +0000 Received: from localhost ([127.0.0.1]:51056 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jzNrf-0006e1-W2 for submit@debbugs.gnu.org; Sat, 25 Jul 2020 13:21:40 -0400 Received: from eggs.gnu.org ([209.51.188.92]:51204) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jzNrb-0006dm-4q for 42516@debbugs.gnu.org; Sat, 25 Jul 2020 13:21:38 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:47528) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jzNrU-0004uZ-Cn; Sat, 25 Jul 2020 13:21:28 -0400 Received: from 84-52-226.102.3p.ntebredband.no ([84.52.226.102]:45310 helo=localhost) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jzNrT-0003Ta-V7; Sat, 25 Jul 2020 13:21:28 -0400 From: Marius Bakke In-Reply-To: <871rl0frpo.fsf@gnu.org> References: <20200724104307.30992-1-me@tobias.gr> <871rl0frpo.fsf@gnu.org> Date: Sat, 25 Jul 2020 19:21:10 +0200 Message-ID: <877durse7t.fsf@gnu.org> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-Spam-Score: -3.3 (---) X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=none; dmarc=none; spf=pass (aspmx1.migadu.com: domain of guix-patches-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=guix-patches-bounces@gnu.org X-Spam-Score: -0.61 X-TUID: beylSP9UAnBb --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Brett Gilio writes: > Tobias Geerinckx-Rice writes: > >> @deffn {Scheme Variable} tlp-service-type >> -The service type for the TLP tool. Its value should be a valid >> -TLP configuration (see below). To use the default settings, simply >> -write: >> +The service type for the TLP tool. The default settings are optimised >> +for battery life on most systems, but you can tweak them to your heart's >> +content by passing a valid @code{tlp-configuration} as its value: >> @lisp >> -(service tlp-service-type) >> +(service tlp-service-type >> + (tlp-configuration >> + (cpu-scaling-governor-on-ac (list "performance")) >> + (sched-powersave-on-bat? #t))) >> @end lisp >> @end deffn >>=20=20 >> -By default TLP does not need much configuration but most TLP parameters >> -can be tweaked using @code{tlp-configuration}. >> - >> Each parameter definition is preceded by its type; for example, >> @samp{boolean foo} indicates that the @code{foo} parameter >> should be specified as a boolean. Types starting with > > I would replace "as its value:" with "to the service type:", so it reads > "... but you can tweak them to your heart's content by passing a valid > tlp-configuration to the service type:" Something about "tweak to your heart's content" rubs me the wrong way, though I can't really explain why. It feels like the manual is passive-aggressively mocking me for trying to understand how to configure the thing. But that's probably just me. :-) --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQEzBAEBCgAdFiEEu7At3yzq9qgNHeZDoqBt8qM6VPoFAl8cagYACgkQoqBt8qM6 VPpoQwgA00InE2LcrkZ9rVV7vNxEUP0gucmixBhif84aTBIWaIfB9RdAyNsjpOBd cSXH6BnEnk9VhqdVKDgltshKf5XIHYrxCdNb78IMoQ2LqCLm7SSrU5+u0beY1/91 3xjmipx8Xvus3AKDc8NzmidM56KKxSRseGolqPUZdH/0dxSg/ZMGJYHDs5lPBiup FH0aLtv/IiUP2UBdmgKQG+SODJGT83WyAXEzMWlQBYDA3CgI2I14XL8sVHeOdP04 Y0B4tCTuJ3/SfByZf9O0NT9OwU9pAYy5EaZA4j7E1hfwuYv8upXOZ8gf97hiveQ1 a75yrhbovLKHacsoQ5G8AsXoTSTzOQ== =5nqU -----END PGP SIGNATURE----- --=-=-=--