all messages for Emacs-related lists mirrored at yhetil.org
 help / color / mirror / code / Atom feed
* Terminology in multi-tty primitives
@ 2008-12-27 18:23 Eli Zaretskii
  2008-12-28  1:00 ` Chong Yidong
  2008-12-28 17:29 ` Richard M Stallman
  0 siblings, 2 replies; 43+ messages in thread
From: Eli Zaretskii @ 2008-12-27 18:23 UTC (permalink / raw)
  To: emacs-devel

The terminology used by the multi-tty primitives is in its current
state very irregular, to the degree that IMO it hampers understanding
and promotes confusion.  Examples:

 . Sometimes we use "tty", as in `suspend-tty' and
   `make-frame-on-tty', and sometimes "terminal", as in
   `delete-terminal'.

 . `terminal-name' returns the name of the _terminal_device_, such as
   "/dev/tty", while a terminal object itself does not really have a
   name.

 . `get-device-terminal' accepts not only a device name (like
   "/dev/tty" or "foo:0.0"), as its name might suggest, but also a
   frame or a terminal.

 . Doc strings of several functions use the term "terminal id", but
   the functions accept a _terminal_object_, not an ID.  Since a
   terminal has an integer ID associated with it
   (cf. `get-device-terminal's return value), a user could easily be
   confused to think that we mean that integer identifier.

Are we OK with these inconsistencies?  If it's just me, I'm willing to
leave this alone and just document the status quo.  Otherwise, this is
our last chance to fix this mess before it is codified and frozen
forever.




^ permalink raw reply	[flat|nested] 43+ messages in thread
* Terminology in multi-tty primitives
@ 2008-12-27 18:16 Eli Zaretskii
  0 siblings, 0 replies; 43+ messages in thread
From: Eli Zaretskii @ 2008-12-27 18:16 UTC (permalink / raw)
  To: emacs-devel

The terminology used by the multi-tty primitives is in its current
state very irregular, to the degree that IMO it hampers understanding
and promotes confusion.  Examples:

 . Sometimes we use "tty", as in `suspend-tty' and
   `make-frame-on-tty', and sometimes "terminal", as in
   `delete-terminal'.

 . `terminal-name' returns the name of the _terminal_device_, such as
   "/dev/tty", while a terminal object itself does not really have a
   name.

 . Doc strings of several functions use the term "terminal id", but
   the functions accept a _terminal_object_, not an ID.  Since a
   terminal has an integer ID associated with it
   (cf. `get-device-terminal's return value), a user could easily be
   confused to think that we mean that integer identifier.

Are we OK with these inconsistencies?  If it's just me, I'm willing to
leave this alone and just document the status quo.  Otherwise, this is
our last chance to fix the terminology before it is documented and
frozen forever.




^ permalink raw reply	[flat|nested] 43+ messages in thread

end of thread, other threads:[~2009-01-04  4:54 UTC | newest]

Thread overview: 43+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2008-12-27 18:23 Terminology in multi-tty primitives Eli Zaretskii
2008-12-28  1:00 ` Chong Yidong
2008-12-28  4:09   ` Eli Zaretskii
2008-12-28  4:28     ` Chong Yidong
2008-12-28 19:18       ` Eli Zaretskii
2008-12-28 19:43         ` Juanma Barranquero
2008-12-29  5:31         ` Chong Yidong
2008-12-29 19:26           ` Eli Zaretskii
2008-12-29 22:09         ` Richard M Stallman
2008-12-30  2:18           ` Stephen J. Turnbull
2008-12-30 22:26             ` Richard M Stallman
2008-12-31  2:06               ` Stefan Monnier
2008-12-31  2:20                 ` Dan Nicolaescu
2008-12-31  3:20                   ` Stefan Monnier
2008-12-31  4:29                     ` Eli Zaretskii
2008-12-31  6:25                       ` Stefan Monnier
2008-12-31 18:47                         ` Eli Zaretskii
2008-12-31 21:39                           ` Dan Nicolaescu
2008-12-31 21:48                             ` Eli Zaretskii
2008-12-31 21:55                               ` Dan Nicolaescu
2008-12-31 22:10                                 ` Eli Zaretskii
2008-12-31 23:03                                   ` Dan Nicolaescu
2008-12-31 16:38                 ` Richard M Stallman
2008-12-31 17:22                   ` Stefan Monnier
2008-12-31 19:05                     ` Eli Zaretskii
2009-01-01 17:13                       ` Stefan Monnier
2009-01-02 13:56                         ` Eli Zaretskii
2009-01-03  2:32                           ` Stefan Monnier
2009-01-03  9:59                             ` Eli Zaretskii
2009-01-04  3:14                               ` Stefan Monnier
2009-01-04  3:29                                 ` Chetan Pandya
2009-01-04  3:41                                   ` Jason Rumney
2009-01-04  4:54                                     ` Chetan Pandya
2008-12-30 22:27             ` Richard M Stallman
2008-12-31  5:31               ` Stephen J. Turnbull
2008-12-31  6:28                 ` Stefan Monnier
2008-12-31  8:33                   ` Stephen J. Turnbull
2008-12-31 14:18                 ` Chong Yidong
2008-12-31 15:42                   ` Stephen J. Turnbull
2008-12-28 17:29 ` Richard M Stallman
2008-12-28 19:33   ` Eli Zaretskii
2008-12-30 19:53   ` Stefan Monnier
  -- strict thread matches above, loose matches on Subject: below --
2008-12-27 18:16 Eli Zaretskii

Code repositories for project(s) associated with this external index

	https://git.savannah.gnu.org/cgit/emacs.git
	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.