From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 26625 invoked by alias); 17 Apr 2014 09:39:56 -0000 Mailing-List: contact gdb-patches-help@sourceware.org; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Archive: List-Post: List-Help: , Sender: gdb-patches-owner@sourceware.org Received: (qmail 26503 invoked by uid 89); 17 Apr 2014 09:39:55 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-0.7 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_NONE,SPF_NEUTRAL autolearn=no version=3.3.2 X-HELO: sasl.smtp.pobox.com Received: from a-pb-sasl-quonix.pobox.com (HELO sasl.smtp.pobox.com) (208.72.237.25) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Thu, 17 Apr 2014 09:39:54 +0000 Received: from sasl.smtp.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id 4B37211E32; Thu, 17 Apr 2014 05:39:52 -0400 (EDT) Received: from a-pb-sasl-quonix.pobox.com (unknown [127.0.0.1]) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTP id 33C7911E31; Thu, 17 Apr 2014 05:39:52 -0400 (EDT) Received: from rusty (unknown [88.160.190.192]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by a-pb-sasl-quonix.pobox.com (Postfix) with ESMTPSA id A0A1B11E30; Thu, 17 Apr 2014 05:39:50 -0400 (EDT) From: Andy Wingo To: Doug Evans Cc: gdb-patches@sourceware.org Subject: Re: [PATCH 5/9] Rename "gsmob" in Guile interface to "gdb object" References: <1397060028-18158-1-git-send-email-wingo@igalia.com> <1397060028-18158-6-git-send-email-wingo@igalia.com> Date: Thu, 17 Apr 2014 09:39:00 -0000 In-Reply-To: (Doug Evans's message of "Sat, 12 Apr 2014 11:46:15 -0700") Message-ID: <87ioq8s3a4.fsf@igalia.com> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.3 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Pobox-Relay-ID: 38EAFF7C-C614-11E3-959A-873F0E5B5709-02397024!a-pb-sasl-quonix.pobox.com X-SW-Source: 2014-04/txt/msg00341.txt.bz2 On Sat 12 Apr 2014 20:46, Doug Evans writes: > Andy Wingo writes: > >> diff --git a/gdb/doc/guile.texi b/gdb/doc/guile.texi >> index 3f6580e..f7204e9 100644 >> --- a/gdb/doc/guile.texi >> +++ b/gdb/doc/guile.texi >> @@ -331,46 +331,45 @@ This is the string passed to @code{--target} when @value{GDBN} was configured. >> >> @node GDB Scheme Data Types >> @subsubsection GDB Scheme Data Types >> -@cindex gdb smobs >> +@cindex gdb objects >> >> -@value{GDBN} uses Guile's @dfn{smob} (small object) >> -data type for all @value{GDBN} objects >> -(@pxref{Defining New Types (Smobs),,, guile, GNU Guile Reference Manual}). >> -The smobs that @value{GDBN} provides are called @dfn{gsmobs}. >> +The values exposed by @value{GDBN} to Guile are known as >> +@dfn{@value{GDBN} objects}. There are several kinds of @value{GDBN} >> +object, and each is disjoint from all other types known to Guile. > > objects You sure? "There are several kinds of GDB object, and..." sounds better to me than "There are several kinds of GDB objects, and...". Maybe it would be better to restructure the sentence; I tried a few other formulations and all sounded worse. Andy