From MAILER-DAEMON Mon Feb 24 14:11:58 2014 Received: from list by lists.gnu.org with archive (Exim 4.71) id 1WI0wY-0007sX-BI for mharc-gforth@gnu.org; Mon, 24 Feb 2014 14:11:58 -0500 Received: from eggs.gnu.org ([2001:4830:134:3::10]:49133) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WI0wP-0007qk-Fh for gforth@gnu.org; Mon, 24 Feb 2014 14:11:56 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WI0wI-0002X1-H3 for gforth@gnu.org; Mon, 24 Feb 2014 14:11:49 -0500 Received: from alt-proxy33.mail.unifiedlayer.com ([70.40.209.146]:49043) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1WI0wI-0002We-5o for gforth@gnu.org; Mon, 24 Feb 2014 14:11:42 -0500 Received: (qmail 23997 invoked by uid 0); 24 Feb 2014 19:10:36 -0000 Received: from unknown (HELO box483.bluehost.com) (66.147.242.83) by oproxy1.mail.unifiedlayer.com with SMTP; 24 Feb 2014 19:10:36 -0000 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=programandala.net; s=default; h=Content-Type:MIME-Version:Message-ID:Subject:To:From:Date; bh=2G29LFb0EXfnQ4iSfcTeaEDcXXokRKhml57ijZwV+6A=; b=Y5+YQTG43DFLurkj5Q4Twy0tJFTEZLfHVGcZcSzTEoh8Ntc0+WDy+WsrFJI+8atY9/NN31XHbsLeQ8cdjG2Zezs/pvv1ZSQ6jaxS9oSwGjue7obtr1g9b3l1wbQgv3E+; Received: from [79.144.123.229] (port=11865 helo=localhost) by box483.bluehost.com with esmtpsa (UNKNOWN:CAMELLIA128-SHA:128) (Exim 4.80) (envelope-from ) id 1WI0vD-0006hD-Hr for gforth@gnu.org; Mon, 24 Feb 2014 12:10:36 -0700 Date: Mon, 24 Feb 2014 20:10:29 +0100 From: Marcos Cruz To: gforth@gnu.org Message-ID: <20140224191029.GF6741@raspesis> Mail-Followup-To: gforth@gnu.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.5.21 (2010-09-15) X-Identified-User: {2263:box483.bluehost.com:alinomen:alinome.net} {sentby:smtp auth 79.144.123.229 authed with sendilo+alinome.net} X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 70.40.209.146 Subject: [gforth] undocumented words X-BeenThere: gforth@gnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Gforth discussion and announcements List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Feb 2014 19:11:56 -0000 Hi, Some times, SEEing some code or because a backtrace error, I find out a useful Gforth-specific word I never heard of. That's how I recently met 'extend-mem'. After searching for it in the sources, I thought it could have been useful some days ago, when I was coding a self-growing buffer I needed :) I always supposed the '\g' line comments are used to mark words to be extracted for the docs, but some words have those comments and are not listed in the docs (e.g. 'save-mem'). Beside, what is the criterion? Of course there are too many inner and tool words that don't need to be mentioned in the docs, but I think 'save-mem' and 'extend-mem' and others would be helpful. They are generic useful words. Thank you. -- Marcos Cruz http://programandala.net