From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from eggs.gnu.org ([2001:470:142:3::10]:54481)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ipSTA-0002VX-7l
 for guix-patches@gnu.org; Thu, 09 Jan 2020 02:43:05 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ipST8-00046M-Um
 for guix-patches@gnu.org; Thu, 09 Jan 2020 02:43:04 -0500
Received: from debbugs.gnu.org ([209.51.188.43]:45800)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <Debian-debbugs@debbugs.gnu.org>)
 id 1ipST8-00044W-Fc
 for guix-patches@gnu.org; Thu, 09 Jan 2020 02:43:02 -0500
Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2)
 (envelope-from <Debian-debbugs@debbugs.gnu.org>) id 1ipST8-000115-Dy
 for guix-patches@gnu.org; Thu, 09 Jan 2020 02:43:02 -0500
Subject: [bug#39048] [PATCH] Clarify description of the Pagekite service.
Resent-Message-ID: <handler.39048.B39048.15785557373831@debbugs.gnu.org>
Date: Thu, 9 Jan 2020 08:42:12 +0100
From: "pelzflorian (Florian Pelz)" <pelzflorian@pelzflorian.de>
Message-ID: <20200109074212.elii3ebtr5j3pz2u@pelzflorian.localdomain>
References: <20200109073128.wi5gsntnypxw4dmn@pelzflorian.localdomain>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20200109073128.wi5gsntnypxw4dmn@pelzflorian.localdomain>
List-Id: <guix-patches.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/guix-patches>,
 <mailto:guix-patches-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/guix-patches>
List-Post: <mailto:guix-patches@gnu.org>
List-Help: <mailto:guix-patches-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/guix-patches>,
 <mailto:guix-patches-request@gnu.org?subject=subscribe>
Errors-To: guix-patches-bounces+kyle=kyleam.com@gnu.org
Sender: "Guix-patches" <guix-patches-bounces+kyle=kyleam.com@gnu.org>
To: Alex Griffin <a@ajgrf.com>
Cc: 39048@debbugs.gnu.org

Hello Alex Griffin,

I see that you added the Pagekite service to Guix and am thankful for
that and for showing me that Pagekite exists.  However I believe users
not familiar with setting up servers could think they need Pagekite in
cases where configuring their NAT to do port forwarding would be
enough.

On Thu, Jan 09, 2020 at 08:31:28AM +0100, Florian Pelz wrote:
> * doc/guix.texi (Networking Services): Make clear Pagekite is not necessary
> with port forwarding.
> ---
>  doc/guix.texi | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/doc/guix.texi b/doc/guix.texi
> index df1ba428a5..2a860db4c8 100644
> --- a/doc/guix.texi
> +++ b/doc/guix.texi
> @@ -14154,8 +14154,8 @@ Package object of the Open vSwitch.
>  @defvr {Scheme Variable} pagekite-service-type
>  This is the service type for the @uref{https://pagekite.net, PageKite} service,
>  a tunneling solution for making localhost servers publicly visible, even from
> -behind NAT or restrictive firewalls.  The value for this service type is a
> -@code{pagekite-configuration} record.
> +behind restrictive firewalls or NAT without forwarded ports.  The value for
> +this service type is a @code{pagekite-configuration} record.
>  
>  Here's an example exposing the local HTTP and SSH daemons:
>  
> -- 
> 2.24.1
> 
> 
> 
> 

I propose this change; do you approve?

Regards,
Florian