annotate lisp/multicast.el @ 502:7039e6323819

[xemacs-hg @ 2001-05-04 22:41:46 by ben] ----------------------- byte-comp warning fixes ----------------- New functions for cleanly eliminating byte-compiler warnings. Their definitions require no changes at all in bytecomp.el, meaning that any package that wants to use them and be compatible with older versions of XEmacs need only copy the code and rename the functions (i.e. prefix them with the package name). Eliminate byte-compiler warnings using the new functions in bytecomp-runtime.el. Move coding-system-put,get,category, since they're not Mule-specific and are used in prefer-coding-system. font.el was incredibly ugly. Clean it up. Avoid using defsubst for any exported functions, to avoid possible compatibility problems if we later change the internal interface. (It happened before, with face accessors, between 19.8 and 19.9). Fix tons of warnings. Clean up (new function gpm-is-supported-p eliminates duplicate code in gpm-create/delete-device-hook) and eliminate warnings. ---------- make byte-recompile-directory work in the --------- core `lisp' dir, even in the absence of a Mule XEmacs (i.e. make it skip the Mule files rather than trying to compile them). now you should be able to do `touch *.el' in the `lisp' dir, then M-x byte-recompile-directory, and get no warnings. Avoid trying to compile Mule files in byte-recompile-directory when we're not in a Mule XEmacs, since we're highly likely to get syntax errors. Add a coding-system cookie to all Mule files so that byte-recompile-directory ignores them. Magic cookie function moved to files.el from code-files.el (for use by bytecomp even in a non-coding-system XEmacs), and changed names and semantics for use by bytecomp. NOTE: IMO this is an internal function that we can change as we like (and there is absolutely no code anywhere else using the function). ---------------- GUI improvements: menus, help ------------------- Rearrange order of keymap declarations to be alphabetical. Improve help on help to include all bindings, and group by category. Add bindings for new Info commands. Remove warnings. Use command-hyper-apropos in place of command-apropos. Add a function to do the equivalent of command-apropos. Evals its help-text argument so you can put expressions there. Used now by help-for-help. Add binding to continue text searches. Expand index searches to work over multiple info documents. Add commands to search text/index in User and Lispref. Add new entry, "Uncomment Region" (parallels "Comment Out Region"). Redo Help menu; add bindings for new Info commands to search the index or text of the User and Lispref manuals. Add command for mark-paragraph, activate-region. Make Edit->R accelerator be rectangle, not register (more commonly used), and put rectangle first. Fix the Edit Init File entry to never load the .elc file. Simplify the default-popup-menu. Add Cmds->Tabs menu. Use kp-left not kp_left, etc. ---------------- Miscellaneous bug fixes/cleanup ------------------- byte-compiler-options: Correct doc string. easy-menu-do-define: fix extra quote. fill-paragraph-or-region:Rewrite to be more correct -- use call-interactively so that we always get exactly the same behavior as if the functions were called directly. No need to fiddle with zmacs-region-stays, now that bogus clearing of it (2001-04-28 src/ChangeLog) is removed. Put dialog titles back in -- this time correctly. Fix various other problems with leaks and such. key-sequence-list-description: Clean up fun to always correctly canonicalize. Clean up Kinsoku comments, synch comment-region with FSF 20.7. * simple.el (region-exists-p): * simple.el (region-active-p): Add comment about which one is correct to use in menu specs. * sound.el (load-sound-file): Minor code clean up. * startup.el: * startup.el (command-line-early): * startup.el (initial-scratch-message): Comment changes. Add info about sample.init.el to splash screen. Improve initial-scratch-message and clarify purpose of Scratch buffer. Fix byte-compile warning. ------------------------ Added features ------------------------- Add new variable to control whether etags checks all parent directories for tag files. (On by default.) * hash-table.el: New file, useful utility functions. * dumped-lisp.el (preloaded-file-list): Dump hash-table.el. ------------ notable bug fix: Windows event code -------------- Get critical quit working. ------------ notable bug fix and new feature: regex code -------------- Shy groups were implemented in a horrible, half-assed way that would cause them to screw up regex searching in most cases. Fixed to work correctly. Also extended back-reference syntax past 9. Only is recognized as such if there are at least that many non-shy groups; and optionally will warn about such uses, to catch old code that might be using them differently. (Added variable to control this in search.c -- `warn-about-possibly-incompatible-back- references', on by default for the moment. Declared in lisp.h. ---------------- process/SIGIO improvements ------------------- define USE_GETADDRINFO to replace more complex conditional, and use it. the code conditionalized on this in unix_open_network_stream had *serious* problems handling errors. it's now fixed, and major amounts of duplicate code between the two versions were combined. don't disable SIGIO and other interrupts unless CONNECT_NEEDS_SLOWED_INTERRUPTS is defined -- don't penalize OS's without bugs. similarly for a freebsd bug that was affecting all OS's. * s\ultrix.h: define CONNECT_NEEDS_SLOWED_INTERRUPTS, since that's the OS mentioned as having a kernel bug. * sysdep.c (request_sigio_on_device): * sysdep.c (unrequest_sigio_on_device): fix SIGIO problems on Linux. add check for O_ASYNC in case it's defined and FASYNC isn't. add comment about other ways to do SIGIO on Linux. * callproc.c (Fold_call_process_internal): * process.c (Fstart_process_internal): Deal with the possibility that `default-directory' doesn't have terminating slash. Correct comments about vfork. ---------------- Miscellaneous bug fixes/cleanup ------------------- * callint.c (Finteractive): Add lots of documentation -- exactly what the Lisp equivalents of all the interactive specs are. * console.h (struct console): change type of quit_char to Emchar. * event-msw.c (lstream_type_create_mswindows_selectable): spacing change. Eliminate events-mod.h and combine into events.h. * emacs.c: * emacs.c (make_arg_list_1): * emacs.c (main_1): A couple of char->Extbyte changes, add a comment. * glyphs-msw.c: Correct indentation of function defns to not exceed 80 cols. Try (sort of) to fix some code that sets the colors of the progress gauge. (Commented out) * keymap.c (syms_of_keymap): use DEFSYMBOL. * process.c (read_process_output): No need to fiddle with zmacs_region_stays, now that bogus clearing of it (see below) is removed. * search.c (Freplace_match): warning fix.
author ben
date Fri, 04 May 2001 22:42:35 +0000
parents 576fb035e263
children 2b6fa2618f76
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
1 ;;; multicast.el --- lisp frontend for multicast connections in XEmacs
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
2
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
3 ;; Copyright (C) 1997-2000 Didier Verna.
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
4
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
5 ;; Author: Didier Verna <didier@xemacs.org>
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
6 ;; Maintainer: Didier Verna <didier@xemacs.org>
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
7 ;; Created: Thu Dec 4 16:37:39 1997
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
8 ;; Last Revision: Mon Jan 19 19:10:50 1998
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
9 ;; Current Version: 0.4
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
10 ;; Keywords: dumped comm processes
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
11
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
12 ;; This file is part of XEmacs.
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
13
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
14 ;; XEmacs is free software; you can redistribute it and/or modify
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
15 ;; it under the terms of the GNU General Public License as published by
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
16 ;; the Free Software Foundation; either version 2 of the License, or
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
17 ;; (at your option) any later version.
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
18
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
19 ;; XEmacs is distributed in the hope that it will be useful,
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
20 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
21 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
22 ;; GNU General Public License for more details.
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
23
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
24 ;; You should have received a copy of the GNU General Public License
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
25 ;; along with this program; if not, write to the Free Software
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
26 ;; Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
27
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
28
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
29 ;;; Commentary:
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
30
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
31 ;; This file just contains a lisp frontend to the internal function
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
32 ;; open-multicast-group-internal written in C and belonging to process.c
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
33 ;; Well, nothing much to say about it ... read the doc string.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
34
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
35
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
36 ;;; Change Log:
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
37
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
38 ;; Rev. of Mon Jan 19 19:04:44 1998 : packaging cleanup
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
39 ;; Rev. of Thu Dec 11 13:54:26 1997 : updated the docstring
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
40 ;; Rev. of Mon Dec 8 15:28:47 1997 : Improved the doc string
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
41 ;; Rev. of Thu Dec 4 16:38:09 1997 : Initial Version.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
42
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
43
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
44 ;;; Code:
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
45
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
46 (defun open-multicast-group (name buffer address)
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
47 "Open a multicast connection on the specified address.
444
576fb035e263 Import from CVS: tag r21-2-37
cvs
parents: 404
diff changeset
48 Returns a process object to represent the connection.
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
49 Input and output work as for subprocesses; `delete-process' closes it.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
50 Args are NAME BUFFER ADDRESS.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
51 NAME is a name for the process. It is modified if necessary to make it unique.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
52 BUFFER is the buffer (or buffer-name) to associate with the process.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
53 Process output goes at the end of that buffer, unless you specify an output
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
54 stream or filter function to handle the output.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
55 BUFFER may be also nil, meaning that this process is not associated with any
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
56 buffer
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
57 ADDRESS specifies a standard multicast address \"dest/port/ttl\":
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
58 dest is an internet address between 224.0.0.0 and 239.255.255.255
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
59 port is a communication port like in traditional unicast
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
60 ttl is the time-to-live (15 for site, 63 for region and 127 for world).
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
61
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
62 WARNING: it is *strongly* recommended to avoid using groups beginning with
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
63 224 or 239. Such groups are considered 'admin' groups, and may
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
64 behave in a surprising way ..."
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
65 (let (dest port ttl)
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
66 ;; We check only the general form of the multicast address.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
67 ;; The rest will be handled by the internal function.
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
68 (string-match "^\\([0-9\\.]+\\)/\\([0-9]+\\)/\\([0-9]+\\)$" address)
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
69 (and (not (and (= (match-beginning 0) 0)
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
70 (= (match-end 0) (length address))))
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
71 (error "malformed multicast address: %s" address))
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
72 (and (not (setq dest (match-string 1 address)))
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
73 (error "invalid destination specification."))
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
74 (and (= 0 (setq port (string-to-int (match-string 2 address))))
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
75 (error "invalid port specification."))
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
76 (and (= 0 (setq ttl (string-to-int (match-string 3 address))))
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
77 (error "invalid ttl specification."))
502
7039e6323819 [xemacs-hg @ 2001-05-04 22:41:46 by ben]
ben
parents: 444
diff changeset
78 (declare-fboundp (open-multicast-group-internal name buffer dest port ttl))
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
79 ))
404
2f8bb876ab1d Import from CVS: tag r21-2-32
cvs
parents: 261
diff changeset
80
261
405dd6d1825b Import from CVS: tag r20-5b29
cvs
parents:
diff changeset
81 ;;; multicast.el ends here