[Bug: 21.4.12] core dump when Gnus tries to access non-existent nntp server.
21 years, 11 months
Steve Youngs
Steve Youngs
================================================================
Dear Bug Team!
Yo Steve T, how do you spell "regression test"? "G n u s" :-)
I came across this because I'm lazy. :-P I haven't yet reconfigured
and reinstalled my INN server. So, consequently, every time I start
Gnus (which I have configured to access the local nntp server) I have
to hit 'y' in response to a "Can't access nntp server on localhost,
start anyway" error.
In 21.5, no problem, just hit 'y' and I'm reading mail.
In 21.4.11, ditto.
In 21.4.12, XEmacs dumps core before I see the question about the
non-existent server.
Here's the result of running under gdb:
Current directory is /usr/local/src/xemacs/src/
GNU gdb 5.2
Copyright 2002 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "i386-slackware-linux"...
(eicq-gdb) run
Starting program: /usr/local/src/xemacs/src/xemacs
Loading eicq-menu...
Loading eicq-menu...done
Loading eicq...
Loading cus-face...
Loading cus-face...done
Loading bytecomp...
Loading bytecomp...done
Loading eicq...done
Program received signal SIGSEGV, Segmentation fault.
0x00000000 in ?? ()
(eicq-gdb) bt
#0 0x00000000 in ?? ()
#1 0x408cccec in db_open () from /lib/libnss_db.so.2
#2 0x408ccdac in internal_setent () from /lib/libnss_db.so.2
#3 0x408cc3ed in _nss_db_endservent () from /lib/libnss_db.so.2
#4 0x408cc6f9 in _nss_db_getservbyname_r () from /lib/libnss_db.so.2
#5 0x40474354 in __getservbyname_r (name=0xbfffd784 "nntp", proto=0x404a2ff8 "tcp", resbuf=0xbfffd60c, buffer=0xbfffd1e4 "ì", buflen=1024, result=0xbfffd608) at ../nss/getXXbyYY_r.c:200
#6 0x4044da23 in gaih_inet_serv (servicename=0xbfffd784 "nntp", tp=0x404a2ff0, req=0xbfffd894, st=0xbfffd634) at ../sysdeps/posix/getaddrinfo.c:253
#7 0x4044db5d in gaih_inet (name=0xbfffd774 "localhost", service=0xbfffd750, req=0xbfffd894, pai=0xbfffd74c) at ../sysdeps/posix/getaddrinfo.c:358
#8 0x4044e66b in getaddrinfo (name=0xbfffd774 "localhost", service=0xbfffd784 "nntp", hints=0xbfffd894, pai=0xbfffd890) at ../sysdeps/posix/getaddrinfo.c:759
#9 0x08129075 in unix_open_network_stream (name=147817012, host=148638636, service=146523340, protocol=1080421380, vinfd=0xbfffd90c, voutfd=0xbfffd908) at process-unix.c:1700
#10 0x081c0107 in Fopen_network_stream_internal (name=147817012, buffer=145680848, host=148638636, service=146523340, protocol=1080421380) at process.c:747
#11 0x080cc8c6 in Ffuncall (nargs=6, args=0xbfffda08) at eval.c:3536
#12 0x08097638 in execute_optimized_program (program=0x85f9c48 "Æ\211\034\eÆ\035ÇÈ\215\210É\r!«\006\rÊ\n\"\025\r:«\t\r＠\023\rA\024ª\nË\r!«\005\r\023\r\024)\t®\002\v\b®\002\f\030\031Ì\016\r\016\016\016\017\n\016\020%,\207", stack_depth=6, constants_data=0x406d803c) at bytecode.c:748
#13 0x080970f1 in funcall_compiled_function (fun=1081418900, nargs=4, args=0xbfffdb6c) at bytecode.c:516
#14 0x080ccad6 in Ffuncall (nargs=5, args=0xbfffdb68) at eval.c:3572
#15 0x08097638 in execute_optimized_program (program=0x85f9c28 "ÃÄ\n\t\b$\207", stack_depth=5, constants_data=0x8ce6898) at bytecode.c:748
#16 0x080970f1 in funcall_compiled_function (fun=147821268, nargs=1, args=0xbfffdccc) at bytecode.c:516
#17 0x080ccad6 in Ffuncall (nargs=2, args=0xbfffdcc8) at eval.c:3572
#18 0x08097638 in execute_optimized_program (program=0xbfffdd34 "\r\f\e\032\t\b!*\207Ýÿ¿Ð¿\t\bä\234Ï\bdôÿ¿lÝÿ¿e\225\031\bÈ·\f\b\230Ýÿ¿\002", stack_depth=2, constants_data=0x8ce6738) at bytecode.c:748
#19 0x0809c075 in Fbyte_code (instructions=147823844, constants=147744552, stack_depth=5) at bytecode.c:2405
#20 0x080cbecc in Feval (form=147707740) at eval.c:3335
#21 0x080c8a62 in condition_case_1 (handlers=147708040, bfun=0x80cb7c8 <Feval>, barg=147707740, hfun=0x80c8acc <run_condition_case_handlers>, harg=1080438756) at eval.c:1652
#22 0x080c8ece in condition_case_3 (bodyform=147707740, var=1080438756, handlers=147708040) at eval.c:1730
#23 0x08098a71 in execute_rare_opcode (stack_ptr=0xbfffdff8, program_ptr=0x8eba3a4 "\035\n«\005Ï\n!\210\r¬\005Ì\v!\210Ð\v!\205þ", opcode=143) at bytecode.c:1273
#24 0x08097374 in execute_optimized_program (program=0x8eba388 "ÆÇ!\210È\f!\e\0162\fÉ\0162ÊËÊÌ\vDE#\032ÊÍÎ\217\035\n«\005Ï\n!\210\r¬\005Ì\v!\210Ð\v!\205þ", stack_depth=7, constants_data=0x8ce6798) at bytecode.c:658
#25 0x080970f1 in funcall_compiled_function (fun=147821240, nargs=1, args=0xbfffe15c) at bytecode.c:516
#26 0x080ccad6 in Ffuncall (nargs=2, args=0xbfffe158) at eval.c:3572
#27 0x08097638 in execute_optimized_program (program=0x8eba2e8 "Æ \210Ç\b!«\003È\207\r＠;¬\006\r＠§«\tÉ\r＠D\rAB\025Ê\r·¬\tË\rÊ\bDC\"\025ÌÍ\b\r#\210\016\030?S\016\027\034\016\026\f;«\006Î\f!ª\002\fÏ\211\032\e\034\031\t«\031\t\211A\021＠\211\022«\020\f\nA＠a«î\n＠\023Ï\211\021¬é\v\031Ð\v!Ñs«\004\vª\017ÒÓ\v!!\210Ô\n\016\026\"\026\026Ï-®\005Õ\016\027!\207xemacI\001", stack_depth=5, constants_data=0x8c86bc8) at bytecode.c:748
#28 0x080970f1 in funcall_compiled_function (fun=147820820, nargs=2, args=0xbfffe2bc) at bytecode.c:516
#29 0x080ccad6 in Ffuncall (nargs=3, args=0xbfffe2b8) at eval.c:3572
#30 0x08097638 in execute_optimized_program (program=0xbfffe324 "Á\bÂ\"\bA＠\bAA\"\207п\t\bTc»\bÀ＠¥\bLæÿ¿V\t\bÈ·\f\bý", stack_depth=3, constants_data=0x8b952e0) at bytecode.c:748
#31 0x0809c075 in Fbyte_code (instructions=146498388, constants=146363088, stack_depth=7) at bytecode.c:2405
#32 0x080cbecc in Feval (form=146366680) at eval.c:3335
#33 0x080c8a62 in condition_case_1 (handlers=146366836, bfun=0x80cb7c8 <Feval>, barg=146366680, hfun=0x80c8acc <run_condition_case_handlers>, harg=1080438756) at eval.c:1652
#34 0x080c8ece in condition_case_3 (bodyform=146366680, var=1080438756, handlers=146366836) at eval.c:1730
#35 0x08098a71 in execute_rare_opcode (stack_ptr=0xbfffe5e8, program_ptr=0x8a54168 "\030\t¬\v\fÎD\211\021\016\030B\026\030\tA\b«\016\tA＠Ña«\004Ѫ+Òª(\016\037«#\tA＠Ña¬\034Ó\f!«\027\016\032®\024ÔÈÕ\f＠\fA＠#!«\004Ѫ\005ʪ\002Ê \210\tA＠Ña«\022\016\032Êa¬\tÊ\036\032Ö\f!\210)ת\002\b))\207pc＠ä/f＠ä/f＠ \001", opcode=143) at bytecode.c:1273
#36 0x08097374 in execute_optimized_program (program=0x8a540d0 "\f;«|\f\211\035«\b\r<«\004\r®nÆ\r\016\031\"A®f\rÇk«\005\016\e®RÆ\r\016\034\"A®JÆ\r\016\035\"A®B\016\030\e\v«\030\rÈÉ\v＠＠＠\v＠＠A＠#k¬\b\v\211A\023\210ªç\v＠＠)®\037\016\036\032\n«\026\rÈÉ\n＠＠\n＠A＠#k¬\b\n\211A\022\210ªé\n＠)\030\r\bB\016\031B\026\031\b))\024Æ\f\016\030\"\211\031A＠Êa«\tËÌÍ\"\210ΪhÎÏÐ\217\030\t¬\v\fÎD\211\021\016\030B\026\030\tA\b«\016\tA＠Ña«\004Ѫ+Òª(\016\037«#\tA＠Ña¬\034Ó\f!«\027"..., stack_depth=7, constants_data=0x8b95300) at bytecode.c:658
#37 0x080970f1 in funcall_compiled_function (fun=145862932, nargs=1, args=0xbfffe74c) at bytecode.c:516
#38 0x080ccad6 in Ffuncall (nargs=2, args=0xbfffe748) at eval.c:3572
#39 0x08097638 in execute_optimized_program (program=0x8eba128 "Æ\e\n?\205£", stack_depth=9, constants_data=0x8ade880) at bytecode.c:748
#40 0x080970f1 in funcall_compiled_function (fun=145862820, nargs=1, args=0xbfffe8bc) at bytecode.c:516
#41 0x080ccad6 in Ffuncall (nargs=2, args=0xbfffe8b8) at eval.c:3572
#42 0x08097638 in execute_optimized_program (program=0x8ee6360 "Æ «\025Ç\t!\210È\r§\n\rÉV\005\b＠\r]!\207Ê \210Ë \210ÌÍ!\210Î \210\016\032\026\eÏ \210\016\034«\004Ð \210\f«\034Ñ\024ÒÓ!«\006Ô \210ª\020\016\035«\fÕ Ö TU«\004× \210\r§\a\rÉV\002\rÑ\e\032Ø\216\016\036?\nÙ\r\003\n?!\211\023+\207", stack_depth=3, constants_data=0x8b18d98) at bytecode.c:748
#43 0x080970f1 in funcall_compiled_function (fun=146433588, nargs=3, args=0xbfffea0c) at bytecode.c:516
#44 0x080ccad6 in Ffuncall (nargs=4, args=0xbfffea08) at eval.c:3572
#45 0x08097638 in execute_optimized_program (program=0x8ee6338 "ÃÄK!¬\tÅÆ!\210ÇÈ!\210É\n\t\b#\207\211", stack_depth=4, constants_data=0x8af7170) at bytecode.c:748
#46 0x080970f1 in funcall_compiled_function (fun=145710396, nargs=1, args=0xbfffeb68) at bytecode.c:516
#47 0x080ccad6 in Ffuncall (nargs=2, args=0xbfffeb64) at eval.c:3572
#48 0x0809dea2 in Fcall_interactively (function=1080352716, record_flag=1080437076, keys=1080438756) at callint.c:941
#49 0x080cb11c in Fcommand_execute (cmd=1080352716, record_flag=1080437076, keys=1080438756) at eval.c:2974
#50 0x080cc854 in Ffuncall (nargs=3, args=0xbfffed48) at eval.c:3536
#51 0x08097638 in execute_optimized_program (program=0x886c8f8 "\r\035Æ\rÇa«\004Ȫ$\rÉk«\004ʪ\034\r¨«\aËÌ\r\"ª\022\r:«\r\r＠¨«\bËÌ\r＠\"ª\002Í!\024)\t«Kt«HÎ\f!\f\032\eÏ\fÐ\"\210\v8\b¬\023Ñ Ò a«\aÓ pa«\006Ô \210ª\004Õ \210Ö×!\eØÙË\vA«\004Úª\002Û\nÜ\v!#\"\210Ö\016\036!\210ÝÙ!*\207Ï\fÐ\"\207\b)", stack_depth=7, constants_data=0x406e7a70) at bytecode.c:748
#52 0x080970f1 in funcall_compiled_function (fun=1081440936, nargs=1, args=0xbfffeea8) at bytecode.c:516
#53 0x080ccad6 in Ffuncall (nargs=2, args=0xbfffeea4) at eval.c:3572
#54 0x0809dea2 in Fcall_interactively (function=1080318780, record_flag=1080438756, keys=1080438756) at callint.c:941
#55 0x080cb11c in Fcommand_execute (cmd=1080318780, record_flag=1080438756, keys=1080438756) at eval.c:2974
#56 0x0812ff12 in execute_command_event (command_builder=0x85c4ba0, event=143097300) at event-stream.c:3924
#57 0x08130722 in Fdispatch_event (event=143097300) at event-stream.c:4210
#58 0x080a6834 in Fcommand_loop_1 () at cmdloop.c:583
#59 0x080a662f in command_loop_1 (dummy=1080438756) at cmdloop.c:494
#60 0x080c8a62 in condition_case_1 (handlers=1080438372, bfun=0x80a6608 <command_loop_1>, barg=1080438756, hfun=0x80a5e34 <cmd_error>, harg=1080438756) at eval.c:1652
#61 0x080a5f57 in command_loop_3 () at cmdloop.c:256
#62 0x080a5f7f in command_loop_2 (dummy=1080438756) at cmdloop.c:267
#63 0x080c85d2 in internal_catch (tag=1080241308, func=0x80a5f74 <command_loop_2>, arg=1080438756, threw=0x0) at eval.c:1318
#64 0x080a61b8 in initial_command_loop (load_me=1080438756) at cmdloop.c:305
#65 0x080c3676 in xemacs_21_4_12_i586_pc_linux (argc=1, argv=0xbffff464, envp=0xbffff46c, restart=0) at emacs.c:2460
#66 0x080c42a7 in main (argc=1, argv=0xbffff464, envp=0xbffff46c) at emacs.c:2829
#67 0x403a817d in __libc_start_main (main=0x80c41f8 <main>, argc=1, ubp_av=0xbffff464, init=0x8082264 <_init>, fini=0x825e570 <_fini>, rtld_fini=0x4000a534 <_dl_fini>, stack_end=0xbffff45c) at ../sysdeps/generic/libc-start.c:129
(eicq-gdb) cont
Continuing.
Fatal error (11).
Your files have been auto-saved.
Use `M-x recover-session' to recover them.
Your version of XEmacs was distributed with a PROBLEMS file that may describe
your crash, and with luck a workaround. Please check it first, but do report
the crash anyway. Please report this bug by invoking M-x report-emacs-bug,
or by selecting `Send Bug Report' from the Help menu. If necessary, send
ordinary email to `crashes(a)xemacs.org'. *MAKE SURE* to include the XEmacs
configuration from M-x describe-installation, or equivalently the file
Installation in the top of the build tree.
*Please* try *hard* to obtain a C stack backtrace; without it, we are unlikely
to be able to analyze the problem. Locate the core file produced as a result
of this crash (often called `core' or `core.<process-id>', and located in
the directory in which you started XEmacs or your home directory), and type
gdb /usr/local/src/xemacs/src/xemacs core
then type `where' at the debugger prompt. No GDB on your system? You may
have DBX, or XDB, or SDB. (Ask your system administrator if you need help.)
If no core file was produced, enable them (often with `ulimit -c unlimited'
in case of future recurrance of the crash.
Lisp backtrace follows:
open-network-stream-internal("nntpd" #<buffer " *server localhost nntp *nntpd**"> "localhost" "nntp" nil)
# bind (coding-system-for-read coding-system-for-write cs-r cs-w protocol service host buffer name)
open-network-stream("nntpd" #<buffer " *server localhost nntp *nntpd**"> "localhost" "nntp")
# bind (buffer)
nntp-open-network-stream(#<buffer " *server localhost nntp *nntpd**">)
# bind (coding-system-for-read coding-system-for-write)
byte-code("..." [pbuffer nntp-open-connection-function coding-system-for-read coding-system-for-write nntp-coding-system-for-write nntp-coding-system-for-read] 2)
# (condition-case ... . ((error) (quit (byte-code "ÁÂ!¨Ã!¨ÄÅÆ\"¨Æ§" ... 3))))
# bind (timer pbuffer buffer)
nntp-open-connection(#<buffer " *nntpd*">)
# bind (connectionless defs server)
nntp-open-server("localhost" nil)
byte-code("..." [gnus-command-method gnus-get-function open-server] 3)
# (condition-case ... . ((quit (message "Quit trying to open server") nil)))
# bind (elem gnus-command-method)
gnus-open-server((nntp "localhost"))
# bind (how confirm)
gnus-start-news-server(nil)
# (unwind-protect ...)
# bind (level did-connect slave dont-connect arg)
gnus-1(nil nil nil)
# bind (slave dont-connect arg)
gnus(nil)
# bind (command-debug-status)
call-interactively(gnus)
command-execute(gnus t)
# bind (_execute_command_keys_ _execute_command_name_ prefix-arg)
execute-extended-command(nil)
# bind (command-debug-status)
call-interactively(execute-extended-command)
# (condition-case ... . error)
# (catch top-level ...)
Program received signal SIGSEGV, Segmentation fault.
0x403b9361 in __kill () at __kill:-1
-1 __kill: No such file or directory.
in __kill
(eicq-gdb) cont
Continuing.
Program terminated with signal SIGSEGV, Segmentation fault.
The program no longer exists.
(eicq-gdb) quit
Inferior GDB finished
================================================================
System Info to help track down your bug:
---------------------------------------
uname -a: Linux eicq 2.4.20 #1 Wed Dec 18 02:14:29 EST 2002 i586 unknown
/usr/local/src/xemacs/configure '--extra-verbose' '--site-prefixes=/usr/local/pgsql:/usr/local/BerkeleyDB.4.1' '--dynamic=yes' '--with-gtk=no' '--with-gnome=no' '--with-toolbars' '--with-wmcommand' '--with-athena=next' '--with-menubars=lucid' '--with-scrollbars=athena' '--with-dialogs=athena' '--with-widgets=athena' '--with-gif' '--with-sound=native,noesd' '--with-site-lisp=no' '--with-site-modules' '--pdump' '--with-mule' '--with-xfs' '--error-checking=all' '--debug' '--memory-usage-stats' '--with-clash-detection' '--prefix=/home/steve/programming/XEmacs/installed/21.4-mule' '--cflags=-ggdb3 -Wall -Wchar-subscripts -Wunused -Wundef -Wshadow -Wsign-compare -Wmissing-declarations -march=k6'
XEmacs 21.4.12 "Portable Code" configured for `i586-pc-linux'.
Compilation / Installation:
Source code location: /usr/local/src/xemacs
Installation prefix: /home/steve/programming/XEmacs/installed/21.4-mule
Additional prefixes: /usr/local/pgsql /usr/local/BerkeleyDB.4.1
Operating system description file: `s/linux.h'
Machine description file: `m/intel386.h'
Compiler: gcc -ggdb3 -Wall -Wchar-subscripts -Wunused -Wundef -Wshadow -Wsign-compare -Wmissing-declarations -march=k6
Relocating allocator for buffers: no
GNU version of malloc: yes
- Using Doug Lea's new malloc from the GNU C Library.
Window System:
Compiling in support for the X window system:
- X Windows headers location: /usr/X11/include
- X Windows libraries location: /usr/X11/lib
- Handling WM_COMMAND properly.
Compiling in support for the Athena widget set:
- Athena headers location: X11/neXtaw
- Athena library to link: neXtaw
Using Lucid menubars.
Using Athena scrollbars.
Using Athena dialog boxes.
Using Athena native widgets.
TTY:
Compiling in support for ncurses.
Compiling in support for GPM (General Purpose Mouse).
Images:
Compiling in support for GIF images (builtin).
Compiling in support for XPM images.
Compiling in support for PNG images.
Compiling in support for JPEG images.
Compiling in support for TIFF images.
Compiling in support for X-Face message headers.
Sound:
Compiling in support for sound (native).
Databases:
Compiling in support for Berkeley database.
Compiling in support for PostgreSQL.
- Using PostgreSQL header file: libpq-fe.h
- Using PostgreSQL V7 bindings.
Internationalization:
Compiling in support for Mule (multi-lingual Emacs).
Compiling in support for XIM (X11R5+ I18N input method).
- Using raw Xlib to provide XIM support.
- Using XFontSet to provide bilingual menubar.
Mail:
Compiling in support for "dot-locking" mail spool file locking method.
Other Features:
Inhibiting IPv6 canonicalization at startup.
Compiling in support for dynamic shared object modules.
Using the new portable dumper.
Compiling in support for extra debugging code.
WARNING: ---------------------------------------------------------
WARNING: Compiling in support for runtime error checking.
WARNING: XEmacs will run noticeably more slowly as a result.
WARNING: Error checking is on by default for XEmacs beta releases.
WARNING: ---------------------------------------------------------
Load-Path Lisp Shadows:
----------------------
nil
Installed XEmacs Packages:
-------------------------
((zenirc:version 1.13 :type regular)
(xslt-process :version 1.11 :type regular)
(xslide :version 1.03 :type regular)
(xemacs-devel :version 1.49 :type single-file)
(xemacs-base :version 1.72 :type regular)
(w3 :version 1.27 :type regular)
(vm :version 7.07 :type regular)
(viper :version 1.35 :type regular)
(view-process :version 1.12 :type regular)
(vhdl :version 1.15 :type regular)
(vc :version 1.33 :type regular)
(tm :version 1.34 :type regular)
(time :version 1.12 :type regular)
(textools :version 1.13 :type regular)
(text-modes :version 1.55 :type single-file)
(texinfo :version 1.22 :type regular)
(supercite :version 1.19 :type regular)
(strokes :version 1.08 :type regular)
(speedbar :version 1.25 :type regular)
(sounds-wav :version 1.1 :type regular)
(sounds-au :version 1.1 :type regular)
(sml-mode :version 0.05 :type regular)
(slider :version 1.13 :type regular)
(sieve :version 1.1 :type regular)
(sh-script :version 1.16 :type regular)
(sgml :version 1.08 :type regular)
(semantic :version 1.15 :type regular)
(scheme :version 1.12 :type regular)
(sasl :version 1.12 :type regular)
(ruby-modes :version 1.0 :type single-file)
(rmail :version 1.13 :type regular)
(reftex :version 1.28 :type regular)
(python-modes :version 1.01 :type single-file)
(psgml-dtds :version 1.02 :type regular)
(psgml :version 1.35 :type regular)
(ps-print :version 1.08 :type regular)
(prog-modes
:version
1
.68
:type
single-file)
(pgg :version 1.02 :type regular)
(perl-modes :version 1.02 :type single-file)
(pcomplete :version 1.02 :type regular)
(pcl-cvs :version 1.64 :type regular)
(pc :version 1.25 :type single-file)
(os-utils :version 1.29 :type single-file)
(ocaml :version 0.03 :type regular)
(net-utils :version 1.28 :type single-file)
(mmm-mode :version 1.0 :type regular)
(misc-games :version 1.16 :type single-file)
(mine :version 1.14 :type regular)
(mew :version 1.17 :type regular)
(mail-lib :version 1.55 :type regular)
(liece :version 1.1 :type regular)
(jde :version 1.38 :type regular)
(ispell :version 1.24 :type regular)
(ilisp :version 1.28 :type regular)
(igrep :version 1.1 :type regular)
(idlwave :version 1.27 :type regular)
(ibuffer :version 1.08 :type regular)
(hm--html-menus :version 1.18 :type regular)
(haskell-mode :version 1.04 :type regular)
(gnats :version 1.15 :type regular)
(general-docs :version 1.0 :type regular)
(games :version 1.13 :type regular)
(fsf-compat :version 1.11 :type single-file)
(frame-icon :version 1.09 :type regular)
(fortran-modes :version 1.01 :type single-file)
(footnote :version 1.15 :type regular)
(eudc :version 1.36 :type regular)
(eterm :version 1.13 :type regular)
(ess :version 1.02 :type regular)
(eshell :version 1.04 :type regular)
(emerge :version 1.09 :type regular)
(elib :version 1.1 :type single-file)
(eieio :version 1.04 :type regular)
(efs :version 1.29 :type regular)
(edt :version 1.12 :type regular)
(edit-utils :version 1.96 :type single-file)
(ediff :version 1.45 :type regular)
(edebug :version 1.14 :type regular)
(ecrypto :version 0.12 :type regular)
(ecb :version 1.01 :type regular)
(docbookide :version 0.05 :type regular)
(dired :version 1.12 :type regular)
(dictionary :version 1.11 :type regular)
(debug :version 1.16 :type regular)
(crisp :version 1.12 :type regular)
(cookie :version 1.14 :type regular)
(cc-mode :version 1.31 :type regular)
(calendar :version 1.19 :type regular)
(calc :version 1.23 :type regular)
(c-support :version 1.16 :type single-file)
(auctex :version 1.32 :type regular)
(apel :version 1.25 :type regular)
(ada :version 1.11 :type regular)
(skk :version 1.23 :type regular)
(mule-ucs :version 1.04 :type regular)
(mule-base :version 1.42 :type regular)
(lookup :version 1.13 :type regular)
(locale :version 1.2 :type regular)
(leim :version 1.19 :type regular)
(latin-unity :version 1.07 :type regular)
(egg-its :version 1.26 :type regular)
(edict :version 1.13 :type regular))
Installed Modules:
-----------------
Features:
--------
(lazy-shot xemacsbug shadow font disp-table color-theme bbdb-w3
browse-url bbdb-sc bbdb-gnus bbdb-snarf bbdb-com bbdb-pgp bbdb
timezone gnus-demon nnir mpg123 overlay patch-keywords supercite-steve
supercite regi mailcrypt boxquote rect nnspool nntp messkeyw earcon
gnus-audio executable gnus-score score-mode gnus-picon gnus-ml
gnus-msg gnus-diary gnus-art mm-uu mm-view nndiary gnus-sum gnus-group
gnus-undo gnus-start gnus-spec gnus-int gnus-range gnus-win nnmail
mail-source message mml mml-sec mml-smime smime dig mml1991 mml2015
pgg pgg-parse pgg-def mm-decode mm-bodies mm-encode mailcap mail-parse
rfc2045 rfc2231 mail-abbrevs sendmail rfc822 mailheader canlock nnoo
gnus gnus-ems gnus-xmas messagexmas ffap tramp-smb tramp regexp-opt
shell comint ring format-spec timer diff-mode ediff-merg ediff-diff
ediff-tbar ediff-wind ediff-help ediff-util ediff-mult ediff-init
ediff vc-hooks balloon-help func-menu eicq-world eicq-meta sb-html
sb-texinfo sb-info info speedbar sb-image dframe assoc filladapt
footnote paren blink-paren pending-del scroll-in-place redo savehist
backup-dir edmacro iswitchb crypt crypt++ recent-files holidays lunar
solar cal-dst cal-persia cal-julian efs-cu diary-lib time appt
calendar cperl-mode font-lock blink-cursor cus-edit cus-load wid-edit
latin-unity-tables latin-unity-latin10 latin-unity-latin9
latin-unity-latin8 latin-unity-latin7 latin-unity-vars latin-unity ell
working avltree stack-m elib-node ps-bdf ps-mule ps-print lpr from
rfc2047 gnus-util netrc nnheader nnheaderxm mail-utils ietf-drums
time-date qp mm-util mail-prsvr parse-time mail-extr ibuffer
image-mode dired-tar compile time-stamp rsz-minibuf big-menubar
byte-optimize advice advice-preload x-compose zenirc-autoloads
xslt-process-autoloads xslide-autoloads xemacs-devel-autoloads
xemacs-base-autoloads w3-autoloads vm-autoloads viper-autoloads
view-process-autoloads vhdl-autoloads vc-autoloads tm-autoloads
time-autoloads textools-autoloads text-modes-autoloads
texinfo-autoloads supercite-autoloads strokes-autoloads
speedbar-autoloads sounds-wav-autoloads sounds-au-autoloads
sml-mode-autoloads slider-autoloads sieve-autoloads
sh-script-autoloads sgml-autoloads semantic-autoloads scheme-autoloads
sasl-autoloads ruby-modes-autoloads rmail-autoloads reftex-autoloads
python-modes-autoloads psgml-dtds-autoloads psgml-autoloads
ps-print-autoloads prog-modes-autoloads pgg-autoloads
perl-modes-autoloads pcomplete-autoloads pcl-cvs-autoloads
pc-autoloads os-utils-autoloads ocaml-autoloads net-utils-autoloads
mmm-mode-autoloads misc-games-autoloads mine-autoloads mew-autoloads
mail-lib-autoloads liece-autoloads jde-autoloads ispell-autoloads
ilisp-autoloads igrep-autoloads idlwave-autoloads ibuffer-autoloads
hm--html-menus-autoloads haskell-mode-autoloads gnats-autoloads
general-docs-autoloads games-autoloads fsf-compat-autoloads
frame-icon-autoloads fortran-modes-autoloads footnote-autoloads
eudc-autoloads eterm-autoloads ess-autoloads eshell-autoloads
emerge-autoloads elib-autoloads eieio-autoloads efs-autoloads
edt-autoloads edit-utils-autoloads ediff-autoloads edebug-autoloads
ecrypto-autoloads ecb-autoloads docbookide-autoloads dired-autoloads
dictionary-autoloads debug-autoloads crisp-autoloads cookie-autoloads
cc-mode-autoloads calendar-autoloads calc-autoloads
c-support-autoloads auctex-autoloads apel-autoloads ada-autoloads
skk-autoloads mule-ucs-autoloads mule-base-autoloads lookup-autoloads
locale-autoloads leim-autoloads latin-unity-autoloads
egg-its-autoloads edict-autoloads tramp-autoloads misc-autoloads
mh-e-autoloads mailcrypt-autoloads gnus-autoloads eicq-autoloads eicq
bytecomp byte-compile eicq-comm eicq-log cus-face outline eicq-menu
bbdb-autoloads lisp-autoloads loadhist auto-show fontl-hooks
x-iso8859-1 slovenian czech romanian ccl mule-help code-cmds
gutter-items menubar-items x-menubar mode-motion mouse itimer
auto-save lisp-mode easymenu iso8859-1 page buff-menu lib-complete
cus-file derived frame text-props obsolete cus-start custom widget
cl-extra mini-cl cl cl-19 packages backquote very-early-lisp
postgresqlv7 postgresql file-coding mule athena-scrollbars cut-buffer
lucid-menubars athena-dialogs x c-balloon-help tty-frames tty toolbar
native-sound scrollbar unix-processes multicast network-streams
subprocesses modules menu-accelerator-support menubar berkeley-db md5
xemacs xim gutter tiff png gif jpeg xface xpm xbm lisp-float-type
linux dialog devices window-system base64)
Recent keystrokes:
-----------------
M-x r e p o r t - x e TAB RET
Recent messages (most recent first):
-----------------------------------
Parsing BBDB... (frobnicating...)
Parsing BBDB... (reading...)
Parsing BBDB...
Loading lazy-shot...done
Loading lazy-shot...
Loading xemacsbug...done
Loading xemacsbug...
XEmacs ready for take-off!!!
Loading fonts-steve...done
fonts initialised
Loading font...done
Loading font...
Loading color-theme...done
Loading color-the
- 2 participants
- 4 comments
As s e e n on NBC, CBS, CNN, and Oprah! 6899PbNp2--9
21 years, 11 months
katie
katie
* Reduce the amount of sleep you need
* Cause wounds to heal faster
* Lose weight while your sleeping
* Become less winded when excersizing
* Put color back in grey hair
* Grow hair back where it had once fallen out
* Tighten skin
* Strengthen bones
* Body builders - use this to build your muscles quicker
..........The List truly goes on and on..........
As seen on NBC, CBS, CNN, and Oprah! The health discovery
that actually reverses aging symptoms without dieting or exercise!
This PROVEN discovery has been reported on by the
New England Journal of Medicine - don't just take our word for it.
In fact we'd like you to receive a F.R.E.E thirty day supply; look and feel
younger, lose weight, reduce sleep, The list goes on, we
encourage you to at least take a look at the information as to
what else it can do
http://hidden.com.ms-script.651685.9873661-0332198763513531841.encode.020...
1883fHeo5-345aMUk6120OAKll24
- 1 participants
- 0 comments
stable package release
21 years, 11 months
Rendhalver [Peter Brown]
Rendhalver [Peter Brown]
hi all
just checking wether people think packages in pre-release are ready to
be moved to stable
is any one having any problems with any of them?
and does anyone have any fixes that need applying to the current set
of packages in pre-release?
if anyone doesnt complain in a day or so i will be releasing them
also on a related note i need a break. so after releasing these
packages i intend to take a break from XEmacs for about 2 week or so,
there are a bunch of things i need to concentrate on for a while.
it isnt a permanent break and i will be taking a look at the mailing
lists every now and again.
if there is anything urgent that needs fixing cc me and i will take a
look at it
--
XEmacs Advocate | Do not try the patience of Wizards,
Gentoo Devotee | for they are subtle and quick to anger.
Perl Hacker | - Elric (Technomage) , Babylon 5.
Apache God | <mailto:rendhalver at xemacs.org> <GnuPG KeyID: AE51D190>
- 3 participants
- 3 comments
xsymbol included in the SUMO tar ball
21 years, 11 months
Uwe Brauer
Uwe Brauer
> |--==> "UB" == Uwe Brauer <oub(a)ucmail.ucm.es> writes:
>
> UB> Hi The issue of *new* packages reminds me: I suggested to
> UB> include x-symbol (which already is distributed in package form)
> UB> in the main distribution.
>
> UB> What is the state of art?
>
> It's on my todo list. Just haven't got to it yet.
Any news on this?
Uwe
- 4 participants
- 9 comments
Questions---Specific: IDE-like functionality; General: how-to resources
21 years, 11 months
Tom Sobczynski
Tom Sobczynski
Background: In my opinion, one of the greatest things about emacs is the everything-plus-kitchen-sink functionality one can access through the editor and associated packages in a unified fashion. After years of using emacsen, I'm relatively well versed in the core functionality pertaining to editing chunks of text. When I encounter a repetitive or unwieldy task, I try to learn how to streamline things by reading up on some unfamiliar feature or mode or package to make my life easier. Sometimes, I know what concept I'm looking for but not where to find the implementation. The concept index is a good start, but often doesn't have the breadth of coverage I need.
General question: Is there a resource, perhaps on the web, where I can search by what I want to do, and find out how others are doing it?
Specific question: I'm editing some code in C. I really like the ClearCase integration, but I'm looking for some additional IDE-like functionality. Specifically, I'd like for XEmacs to take me to the soure for a function call currently under the point, and I'd like something like tab completion for variables and functions accessible from my current scope. I know this must be a solved problem, but I haven't found this functionality so far by browsing the documentation. This inability to find something I know must be there is the driving force for my general question above.
Thanks in advance,
Tom
- 2 participants
- 1 comments
sgml-mode related crash
21 years, 11 months
Ted Dustman
Ted Dustman
This bug report will be sent to the XEmacs Development Team,
not to your local site managers!!
Please write in English, because the XEmacs maintainers do not have
translators to read other languages for them.
Please describe as succinctly as possible:
- What happened.
- What you thought should have happened.
- Precisely what you were doing at the time.
Please also include any C or lisp back-traces that you may have.
================================================================
Dear Bug Team!
Xemacs crashes when the following file is opened. I'm sorry I've included
so much of this file but I couldn't create a shorter version that would
cause the crash. I believe the crash is related to this piece of text
occuring multiplie times:
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-default-dtd-file:"<top-of-cvs-tree>/doc/Utilities/XML/docbook.ced"
sgml-omittag:nil
sgml-shorttag:nil
End:
-->
This text occurs once at the end of the file for the purpose of configuring
sgml-mode and other times in the text as examples of its usage.
Start of file:
<?xml version="1.0" encoding="UTF-8" ?>
<!--
The contents of this file are subject to the University of Utah Public
License (the "License"); you may not use this file except in compliance
with the License.
Software distributed under the License is distributed on an "AS IS"
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
License for the specific language governing rights and limitations under
the License.
The Original Source Code is SCIRun, released March 12, 2001.
The Original Source Code was developed by the University of Utah.
Portions created by UNIVERSITY are Copyright (C) 2001, 1994
University of Utah. All Rights Reserved.
-->
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"../Utilities/XML/Docbook_dtd/docbookx.dtd" [
<!ENTITY ltx "LaTeX">
<!ENTITY sr "SCIRun">
<!ENTITY dbk "DocBook">
]>
<article class="techreport">
<title>&sr; Documentum</title>
<subtitle>&sr; Documentation (Explicated)</subtitle>
<articleinfo>
<author>
<firstname>Ted</firstname>
<surname>Dustman</surname>
<affiliation>
<orgname>Scientific Computing and Imaging Institute</orgname>
<address>
<street>50 S. Central Campus Dr.</street>
<city>Salt Lake City</city>
<state>UT</state>
<postcode>84112</postcode>
<email>dustman(a)cvrti.utah.edu</email>
<phone>801-587-9513</phone>
</address>
</affiliation>
</author>
</articleinfo>
<section id="sec.intro">
<title>Introduction</title>
<para>This document is for those who wish to write or build (or
both) &sr; documentation.</para>
<para>It describes:
<itemizedlist>
<listitem>
<para>The organization of the documentation tree.</para>
</listitem>
<listitem>
<para>The types of documents in the tree.</para >
</listitem>
<listitem>
<para>How to build document products from their
sources (and the tools needed to do this).</para>
</listitem>
<listitem>
<para>How to edit documents.</para>
</listitem>
</itemizedlist>
</para>
</section>
<section id="sec.overview">
<title>Doc Tree Organization</title>
<para><xref linkend="tbl.doc-tree"/> shows the organization of the
doc tree. It shows only those directories and files that are part of CVS.
Generated files (aka products) are
discussed in a <link linkend="sec.srcsprds">later</link> section.
</para>
<para>
<table id="tbl.doc-tree">
<title>Doc Tree Organization</title>
<tgroup cols="2">
<thead>
<row>
<entry>Directory</entry>
<entry>Description and Important Files</entry>
</row>
</thead>
<tbody>
<row>
<entry><filename>doc</filename></entry>
<entry><para>Root of doc tree. <filename>Index.rhtml</filename> is the main
cover page for the documentation tree. This directory's Makefile
initiates the building of the entire doc tree.</para></entry>
</row>
<row>
<entry><filename>doc/Documentum</filename></entry>
<entry><para><quote>Document documentation</quote>. Document
templates for XHTML and DocBook documents.</para></entry>
</row>
<row>
<entry><filename>doc/Utilities/XML</filename></entry>
<entry>
<para>XSL style files, DTDs and CEDs (precompiled dtds for use with Emacs PSGML
mode), and XML related scripts.</para>
</entry>
</row>
<row>
<entry><filename>doc/Utilities/TeX</filename></entry>
<entry>
<para><x; related style files, macros files, and scripts.
</para>
</entry>
</row>
<row>
<entry><filename>doc/Utilities/HTML</filename></entry>
<entry><para>CSS style files, javascript sources, and HTML related
scripts.</para></entry>
</row>
<row>
<entry><filename>doc/Utilities/Figures</filename></entry>
<entry><para>Shared figures (e.g. page header and footer banners).</para></entry>
</row>
<row>
<entry><filename>doc/User</filename></entry>
<entry>
<para>User documentation root. <filename>Index.rhtml</filename> is the
cover page for &sr; user documentation. This directory's Makefile
initiates the building of the user documentation set.
</para>
</entry>
</row>
<row>
<entry><filename>doc/User/Tutorial</filename></entry>
<entry><para>HTML sources and figures for the &sr; Tutorial</para></entry>
</row>
<row>
<entry><filename>doc/User/Guide</filename></entry>
<entry><para><x; sources for the &sr; users guide.
<filename>Makefile</filename> is responsible for building web and print
versions of the guide.
</para></entry>
</row>
<row>
<entry><filename>doc/User/FAQ</filename></entry>
<entry><para>XML sources for the user FAQ.</para></entry>
</row>
<row>
<entry><filename>doc/Developer/</filename></entry>
<entry>
<para>
Developer documentation root. <filename>Index.rhtml</filename> is the cover
page for &sr; developer documentation. This directory's Makefile
initiates the building of the developer documentation set.
</para>
</entry>
</row>
<row>
<entry><filename>doc/Developer/Guide</filename></entry>
<entry>
<para>XML and HTML sources for the &sr; developers
guide. <filename>Makefile</filename> builds the HTML version of the
guide.</para>
</entry>
</row>
<row>
<entry><filename>doc/Developer/FAQ</filename></entry>
<entry>
<para>XML sources for developer FAQ.</para>
</entry>
</row>
<row>
<entry><filename>doc/Developer/CodeViews</filename></entry>
<entry>
<para>Tools (Makefile, configuration file, and script) for building source
code (C++) based documentation using Doxygen.
</para>
</entry>
</row>
<row>
<entry><filename>doc/Developer/Modules</filename></entry>
<entry>
<para>
<filename>Makefile</filename> builds HTML versions of the module
descriptions. <filename>Index.rhtml</filename> is cover page for module
descriptions. Note that module descriptionn sources live in the
<filename>XML</filename> and <filename>TeX</filename> directories on the
<filename>src</filename> side of the tree.
</para>
</entry>
</row>
<row>
<entry><filename>doc/Installation/</filename></entry>
<entry>
<para>Installation documentation root. <filename>Makefile</filename>
invokes sub-makes. <filename>Index.rhtml</filename> is the cover page for
&sr; installation documentation.</para>
</entry>
</row>
<row>
<entry><filename>doc/Installation/Guide</filename></entry>
<entry>
<para>XML sources for installation guide and
<filename>Makefile</filename> for generating the guide.</para>
</entry>
</row>
<row>
<entry><filename>doc/Installation/FAQ</filename></entry>
<entry>
<para>XML sources for installation FAQ.</para>
</entry>
</row>
<row>
<entry><filename>doc/FAQBook</filename></entry>
<entry>
<para>XML source (<filename>faqbook.xml</filename>) for the &sr; FAQ book
(it merely assembles FAQ sources into book form).</para>
<para><filename>Makefile</filename> generates the FAQ book.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</section>
<section id="sec.builddocs">
<title>Building Docs</title>
<para>&sr; documents are written in number of <firstterm><link
linkend="sec.docmls">markup</link></firstterm> languages: XML, <x;,
and HTML (plus their <firstterm>eruby</firstterm>
equivalents—see <xref endterm="sec.docmls.title"
linkend="sec.docmls"/> for more information). XML and <x; document
sources must be <quote>built</quote> or transformed into other forms
(e.g. HTML) for presentation. This section shows how to invoke the
build system.</para>
<para>This section assumes that all necessary
<link linkend="sec.tools">tools</link> have been installed.</para>
<para>Three environment variables must be set before building
the documentation:
<simplelist>
<member><envar>CLASSPATH</envar> must contain the path of the
file <filename>saxon.jar</filename> within the Saxon distribution.
</member>
<member><envar>STYLESHEET_PATH</envar> must point to the location of the
<filename>html</filename> directory within the &dbk; stylesheet
distribution.
</member>
<member>
<envar>WITH_CV</envar> should be set to the string <quote>true</quote>
if you want Doxygen to build the C++ based documentation.
</member>
</simplelist>
For instance (assuming a Bourne type shell):
<programlisting>
export CLASSPATH=/usr/local/lib/Saxon/saxon.jar
export STYLESHEET_PATH=/usr/local/xsl/docbook/html/
export WITH_CV=true
</programlisting>
</para>
<para>Now to make (all) docs <command>cd</command> to the toplevel
<filename>doc</filename> directory and type <command>make</command>.
</para>
<para>To also make a doc tarball type this:
<programlisting>
cd doc # cd to topleve doc directory
make tarball
</programlisting>
</para>
<para>You may want to build one particular doc or a particular set of docs.
You can do
so by <command>cd</command>'ing to the directory of interest and typing
<command>make</command>. For example:
<programlisting>
cd doc/Developer # Make all developer docs.
make
</programlisting> or
<programlisting>
cd doc/Developer/Guide # Make just the developer's guide.
make
</programlisting>
</para>
<para>To remove <quote>incidental</quote> files (but
no products) from a directory (and its sub-directories) type:
<programlisting>make clean</programlisting>
</para>
<para>To also remove products (generated files) type:
<programlisting>make veryclean</programlisting>
</para>
</section>
<section id="sec.srcsprds">
<title>Sources, Makefiles, and Products</title>
<para>The term <firstterm>sources</firstterm> refers to
files that are created and edited manually. The term
<firstterm>products</firstterm> refers to files that are generated from sources by a
tool of some sort. Sources are always part of the CVS repository and
products never are.</para>
<para>
Makefiles are responsible for generating products from sources.
<xref linkend="tbl.srcprd"/> shows sources, corresponding Makefiles, and
the products they generate. Products that are not explicit targets of
<filename>Makefile</filename> are not shown.</para>
<para>The doc tree uses a conventional recursive makefile
approach to building documentation. Some Makefiles generate products (see
<xref linkend="tbl.srcprd"/>) while others
(<filename>doc/Developer/Makefile</filename>,
<filename>doc/Installation/Makefile</filename>,
<filename>doc/User/Makefile</filename>) merely invoke sub-make processes.
The topmost Makefile (<filename>doc/Makefile</filename> initiates the build
of the entire documentation set. Its other important function is to make
a documentation tarball</para>
<para>The doc tree and its build system were designed so that anyone with
the proper <link linkend="sec.tools">tools</link> can build documentation.
This facilitates the edit/compile/test/debug cycle. The doc developer need
not wait for the doc tree to be published on the internal web site before
discovering bugs and errors. The doc developer can edit sources, invoke
make to build products, test and debug the docs with his web browser, and
correct problems all before committing his changes to the CVS
repository.</para>
<para>Note that Makefiles are written in the GNU make dialect.</para>
<para>Below you will notice files with extensions
<filename>.rxml</filename>, <filename>.rhtml</filename>, and
<filename>.rtex</filename>. These are <firstterm>eruby</firstterm>
sources. Information on these type of files can be found in <xref
endterm="sec.docmls.title" linkend="sec.docmls"/>.</para>
<para>
<table id="tbl.srcprd">
<title>Sources, Makefiles, and Products</title>
<tgroup cols="3">
<thead>
<row>
<entry>Source(s)</entry>
<entry>Makefile</entry>
<entry>Product(s)</entry>
</row>
</thead>
<tbody>
<row>
<entry><para><filename>doc/index.rhtml</filename></para></entry>
<entry><para><filename>doc/Makefile</filename></para></entry>
<entry><para><filename>doc/index.html</filename></para></entry>
</row>
<row>
<entry><para><filename>doc/Developer/index.rhtml</filename></para></entry>
<entry><para><filename>doc/Developer/Makefile</filename></para></entry>
<entry><para><filename>doc/Developer/index.html</filename></para></entry>
</row>
<row>
<entry><para>C++ sources in the src side of the tree</para></entry>
<entry><para><filename>doc/Developer/CodeViews/Makefile</filename></para></entry>
<entry><para><filename>doc/Developer/CodeViews/html/*.html</filename></para></entry>
</row>
<row>
<entry>
<para><filename>doc/Developer/Guide/main.rxml</filename>,
<filename>doc/Developer/Guide/dev/*.xml</filename>, and
<filename>doc/Developer/Guide/src/*.xml</filename></para>
</entry>
<entry><para><filename>doc/Developer/Guide/Makefile</filename></para></entry>
<entry><para><filename>doc/Developer/Guide/*.html</filename></para></entry>
</row>
<row>
<entry>
<para><filename>src/Dataflow/XML/*.xml</filename> and
<filename>src/Packages/*/Dataflow/XML/*.xml</filename></para>
</entry>
<entry><para><filename>doc/Developer/Modules/Makefile</filename></para></entry>
<entry>
<para><filename>src/Dataflow/XML/*.html</filename> and
<filename>src/Packages/*/Dataflow/XML/*.html</filename></para>
</entry>
</row>
<row>
<entry><para><filename>doc/FAQBook/faqbook.xml</filename>,
<filename>doc/Developer/FAQ/faq.xml</filename>,
<filename>doc/Installation/FAQ/faq.xml</filename>, and
<filename>doc/User/FAQ/faq.xml</filename></para></entry>
<entry><para><filename>doc/FAQBook/Makefile</filename></para></entry>
<entry><para><filename>doc/FAQBook/*.html</filename></para></entry>
</row>
<row>
<entry><para><filename>doc/Installation/index.rhtml</filename></para></entry>
<entry><para><filename>doc/Installation/Makefile</filename></para></entry>
<entry><para><filename>doc/Installation/index.html</filename></para></entry>
</row>
<row>
<entry><para><filename>doc/Installation/Guide/*.[r]xml</filename></para></entry>
<entry><para><filename>doc/Installation/Guide/Makefile</filename></para></entry>
<entry><para><filename>doc/Installation/Guide/*.html</filename></para></entry>
</row>
<row>
<entry><para><filename>doc/User/index.rhtml</filename></para></entry>
<entry><para><filename>doc/User/Makefile</filename></para></entry>
<entry><para><filename>doc/User/index.html</filename></para></entry>
</row>
<row>
<entry>
<para><filename>doc/User/Guide/*.[r]tex</filename>,
<filename>src/Dataflow/XML/*.xml</filename>,
<filename>src/Dataflow/Modules/*/doc/*.jpg</filename>,
<filename>src/Dataflow/Modules/*/doc/*.gif</filename>,
<filename>src/Dataflow/TeX/*/*.tex</filename>,
<filename>src/Dataflow/TeX/*/*.jpg</filename>,
<filename>src/Dataflow/TeX/*/*.gif</filename>,
<filename>src/Packages/*/Dataflow/XML/*.xml</filename>,
<filename>src/Packages/*/Dataflow/Modules/*/doc/*.jpg</filename>,
<filename>src/Packages/*/Dataflow/Modules/*/doc/*.gif</filename>,
<filename>src/Packages/*/Dataflow/TeX/*.tex</filename>,
<filename>src/Packages/*/Dataflow/TeX/*/*.jpg</filename>,
<filename>src/Packages/*/Dataflow/TeX/*/*.gif</filename>.</para>
</entry>
<entry><para><filename>doc/User/Guide/Makefile</filename></para></entry>
<entry>
<para>
<filename>doc/User/Guide/usersguide.ps</filename> and
<filename>doc/User/Guide/usersguide/</filename>.
</para>
<para>Intermediate products
<filename>doc/User/Guide/userguide.dvi</filename>, <filename>*_modules.tex</filename> and
<filename>srugmacros.sty</filename> are generated.
</para>
<para>EPS files on
the <filename>src</filename> side of the tree generated from JPEG
and GIF files.</para>
</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
</section>
<section id="sec.docmls">
<title id="sec.docmls.title">Documents and Their Markup Languages</title>
<para>Each document is composed in one (or more) of the following markup
languages (ML):
<itemizedlist>
<listitem>
<para><ulink url="http://www.latex.org"><x;</ulink></para></listitem>
<listitem>
<para><ulink
url="http://docbook.org/tdg/en/html/docbook.html">&dbk;</ulink></para></l...>
<listitem>
<para>The (home grown) Component (or module) ML</para></listitem>
<listitem>
<para>The (home grown) FAQ ML</para></listitem>
<listitem>
<para>HTML</para></listitem>
</itemizedlist>
<xref linkend="tbl.mls"/> provides document specific details.
</para>
<para>A number of &dbk;, HTML, and <x; source documents contain
snippets of Ruby code. These <quote>eruby</quote> (embedded ruby)
source documents may be identified by their extensions:
<filename>.rxml</filename> for &dbk; (or other XML) sources,
<filename>.rhtml</filename> for HTML sources, and
<filename>.rtex</filename> for <x; documents. Products
(<filename>.xml</filename>, <filename>.html</filename>, and
<filename>.tex</filename> files) are generated by replacing the code
snippets with the results of their execution—the eruby tool
executes this code and performs the replacement. <note> <para>Be sure
to edit the eruby version of a document (if it exists) rather than its
product equivalent.</para></note></para>
<para>
<table id="tbl.mls">
<title>Document Types</title>
<tgroup cols="2">
<thead>
<row>
<entry>Document(s)</entry>
<entry>ML(s)</entry>
</row>
</thead>
<tbody>
<row>
<entry>Developer Guide</entry>
<entry>&dbk; and HTML</entry>
</row>
<row>
<entry>FAQs</entry>
<entry>&sr; FAQ ML</entry>
</row>
<row>
<entry>Installation Guide</entry>
<entry>&dbk;</entry>
</row>
<row>
<entry>Module Descriptions</entry>
<entry>&sr; Component (or Module) ML and <x;</entry>
</row>
<row>
<entry>Tutorial</entry>
<entry>HTML</entry>
</row>
<row>
<entry>Users Guide</entry>
<entry><x;</entry>
</row>
<row>
<entry>"Cover Pages" (index.html files)</entry>
<entry>HTML</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para>Later sections provide information on editing these documents.</para>
<para>The Component (or module) and FAQ markup languages were developed by
SCI. The former is defined by its DTD which is in the file
<filename>doc/Utilities/XML/component.dtd</filename>. The latter is defined
by its DTD - <filename>doc/Utilities/XML/faq.dtd</filename>.</para>
<para>This document (the one you are reading) is composed in the &dbk;
ML.</para>
</section>
<section>
<title>Documents and Their CSS Stylesheets</title>
<para>
<xref linkend="cssusage"/> shows CSS stylesheets and the documents
that use them. Stylesheets can be found in
<filename>doc/Utilities/HTML</filename>
</para>
<para>
<table id="cssusage">
<title id="cssusagetitle">Stylesheet Usage</title>
<tgroup cols="2">
<thead>
<row>
<entry>Stylesheet</entry>
<entry>Document(s)</entry>
</row>
</thead>
<tbody>
<row>
<entry><filename>srdocbook.css</filename></entry>
<entry>Docbook Documents</entry>
</row>
<row>
<entry><filename>srlatex2html.css</filename></entry>
<entry>Latex Documents</entry>
</row>
<row>
<entry><filename>mainindex.css</filename></entry>
<entry>doc/index.html</entry>
</row>
<row>
<entry><filename>subindex.css</filename></entry>
<entry>Second level index files (e.g. <filename>doc/User/index.html</filename>)</entry>
</row>
<row>
<entry><filename>pkgindex.css</filename></entry>
<entry><filename>doc/Developer/Modules/index.html</filename></entry>
</row>
<row>
<entry><filename>moduleindex.css</filename></entry>
<entry><filename>doc/Developer/Modules/SCIRun.html</filename>,
etc. (i.e. HTML files generated by the program
<filename>doc/Utilities/HTML/makepkgindex.rb)</filename></entry>
</row>
<row>
<entry><filename>faq.css</filename></entry>
<entry>FAQ documents.</entry>
</row>
<row>
<entry><filename>component.css</filename></entry> <entry>Module
descriptions generated by
<filename>doc/Utilities/XML/component.xsl</filename>.</entry>
</row>
</tbody>
</tgroup>
</table>
</para>
<para><quote>Why so many bloody style sheets?</quote> you may
ask. Because its too bloody hard to write, debug, and maintain a
one-size-fits-all stylesheet!</para>
<note>
<title>A Philosophical Note</title>
<para>My personal philosophy is to:
<itemizedlist>
<listitem>
<para>Avoid writing a "one-size-fits-all" stylesheet. Doing so
creates a large stylesheet (filled with lots of classes) which is hard
to understand and debug and which makes writing documents more
difficult.</para>
</listitem>
<listitem>
<para>Associate 1 stylesheet per document class—which is why there are
so many stylesheets above.</para>
</listitem>
<listitem>
<para>Write XHTML/HTML documents
using no presentational markup nor using the inline
<literal>style</literal> attribute (although I sometimes use the<sgmltag
class="starttag">style</sgmltag> element).</para>
</listitem>
<listitem>
<para>Write stylesheets using the minimum number of style classes.
This rule simplifies stylesheets and the documents that use them
although it increases the number of stylesheets needed.</para>
</listitem>
</itemizedlist>
</para>
</note>
</section>
<section>
<title>Editing Documents</title>
<section id="sec.xmlmode">
<title>Editing XML Documents</title>
<para>This section discusses the use of emacs to edit XML documents.</para>
<para>
An ordinary text editor may be used to edit XML document content. However,
it is easy to get lost in the noise of XML syntax. Therefore, it is best
to use an XML DTD aware editor. This type of editor will help you
construct valid XML documents.
</para>
<para>Emacs is one such editor. It supports an editing environment called
XML mode (which is really a derivative of PSGML mode). XML mode highlights
XML syntax, indents nested elements and their content, and automatically
inserts elements and attributes based on the position of the insertion
point. It is still possible, though, to create invalid documents using
Emacs XML mode.
</para>
<para>Emacs XML mode can be used to edit XML based module descriptions,
XHTML documents, &dbk; documents, and any XML based language which is
described by a DTD.</para>
<para>
Recent versions of Emacs come with XML mode installed. You can check
if yours does by typing <userinput>M-x xml-mode</userinput>. You don't have
XML mode if you get the message
<screen>[No match]</screen> in return.
If you don't have XML mode you may get it
<ulink url="http://www.lysator.liu.se/~lenst/about_psgml/psgml.html">online</ulink>.
</para>
<section id="sec.dotemacs">
<title>Emacs Initialization (.emacs)</title>
<para>The following lisp code should be inserted into your <filename>.emacs</filename>
file:
<programlisting>
<![CDATA[
; Tell emacs to use sgml/xml mode for the following file types.
(setq auto-mode-alist
(append
'(("\\.xml" . xml-mode)
("\\.xhtml" . xml-mode))
auto-mode-alist))
(autoload 'sgml-mode "psgml" "Major mode to edit SGML files." t)
(autoload 'xml-mode "psgml" "Major mode to edit XML files." t)
; Create some faces for use with sgml/xml mode.
; Change colors to suite your fancy.
(make-face 'sgml-start-tag-face)
(set-face-foreground 'sgml-start-tag-face "MediumSeaGreen")
(make-face 'sgml-end-tag-face)
(set-face-foreground 'sgml-end-tag-face "SeaGreen")
(make-face 'sgml-entity-face)
(set-face-foreground 'sgml-entity-face "Red")
(make-face 'sgml-doctype-face)
(set-face-foreground 'sgml-doctype-face "firebrick")
(make-face 'sgml-comment-face)
(set-face-foreground 'sgml-comment-face "blue")
; Use faces defined above.
(setq sgml-set-face t)
(setq sgml-markup-faces
'((comment . sgml-comment-face)
(start-tag . sgml-start-tag-face)
(end-tag . sgml-end-tag-face)
(doctype . sgml-doctype-face)
(entity . sgml-entity-face)))
]]>
</programlisting>
</para>
</section>
<section id="sec.createxmldoc">
<title>Creating an XML Document </title>
<para>
To start a new XML document do this:
<itemizedlist>
<listitem>
<para>Create a new file (<userinput>C-x C-f</userinput>) with a suffix of <filename>.xml</filename></para>
</listitem>
<listitem>
<para>Insert a preamble. The following is a preamble for a &dbk; document:
<programlisting>
<![CDATA[
<?xml version="1.0"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD &dbk; XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
]]>
</programlisting>
</para>
</listitem>
<listitem>
<para>Insert the following XML comment at the bottom of the file.
<programlisting>
<![CDATA[
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-default-dtd-file:"<top-of-cvs-tree>/doc/Utilities/XML/docbook.ced"
sgml-omittag:nil
sgml-shorttag:nil
End:
-->
]]>
</programlisting>
Where <quote><top-of-cvs-tree></quote> is a relative path from your
document to the root of your &sr; CVS tree.
</para>
<para>Note that the file <filename>docbook.ced</filename> is a precompiled
DTD for the docbook language. You will find a 2 other
<filename>.ced</filename> files in <filename>doc/Utilities/XML/</filename>.
These are <filename>component.ced</filename>, for module descriptions, and
<filename>xhtml1-transitional.ced</filename> for XHTML.</para>
</listitem>
<listitem>
<para>
Save your file, close it, and re-open it. Now you may begin editing your
file using xml mode.
</para>
</listitem>
</itemizedlist>
</para>
</section>
<section>
<title>XML-Mode Survival</title>
<para>This section presents a few of the most important XML-mode editing
commands. See the
<ulink url="http://www.lysator.liu.se/~lenst/about_psgml/psgml.html">online
manual</ulink>
for complete documentation. Note that the remainder of this section has been
lifted from
<ulink url="http://www.lysator.liu.se/~lenst/about_psgml/psgml.html#Edit">this section</ulink> of the online manual.
<variablelist>
<varlistentry>
<term><userinput>C-c <</userinput></term>
<listitem>
<para>Will ask, for the tag to insert, in the mini-buffer with completion
on the tags that are valid at point (sgml-insert-tag).</para> <para>If
sgml-auto-insert-required-elements is non-nil, tags for elements required
between the inserted tags will also be inserted.
</para>
<para>The list of valid tags, computed for a position in the buffer, will
contain:
<orderedlist>
<listitem>
<para>The end-tag for the current element, if it can be ended at the
position. Furthermore it will contain end-tags for enclosing elements if
the necessary omissible end-tag declarations have been made in the DTD.
</para>
</listitem>
<listitem>
<para>The start-tags of all elements that could occur after point. If
sgml-omittag-transparent is nil, the above will be limited to the elements
that can occur within the current element.</para> </listitem></orderedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><userinput>C-c C-e</userinput></term>
<listitem>
<para>Insert start and end-tags for an element (sgml-insert-element). The
name of the element is read from the mini-buffer with completion on valid
elements. If sgml-insert-end-tag-on-new-line is non-nil or the element has
element content, the end-tag will be inserted on a new line after the
start-tag.
</para>
<para>If sgml-omittag-transparent is nil, the list of valid elements will
only contain the elements that can be in the content of the current
element.</para> <para>Required elements in the content will be
automatically inserted if the option sgml-auto-insert-required-elements is
non-nil. When the content model demands an element but there is more than
one to choose from, a comment can be inserted with the available choices if
the option sgml-insert-missing-element-comment is non-nil.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><userinput>C-c C-i</userinput></term>
<listitem>
<para>Inserts a new element in the current element where it is
legal. Prompts for element name with completion. The completion list
contains all elements that could be added to the current element somewhere,
without making the content invalid. This assumes that the content is valid
to begin with. Currently this list only has regular elements, not
inclusions. The new element will be inserted as late as possible in the
current element (unless prefix argument is given, then as early as
possible.) </para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>C-c C-r</userinput></term>
<listitem>
<para>Makes the region into a new element (sgml-tag-region). Reads element
name from mini-buffer with completion as for C-c C-e.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><userinput>C-c /</userinput></term>
<listitem>
<para>Inserts an end-tag for the current element (sgml-insert-end-tag).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><userinput>C-c RET</userinput></term>
<listitem>
<para>Split the current element at point. If repeated, the containing
element will be split before the beginning of then current element.</para>
<para>Typical use is to start a new paragraph element when inside a
paragraph.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><userinput>C-c +</userinput></term>
<listitem>
<para>Read attribute name and value from mini-buffer and insert attribute
specification (sgml-insert-attribute). If point is immediately after a
start-tag, this command operates on that start-tag. Otherwise the command
will operate on the element after point.
</para>
<para>The attribute name will be read with completion. If the attribute has a
token list as declared value the attribute value will also be read with
completion. The prompt for attribute value will typically look like:</para>
<screen>Value for attribute (type Default: current value):</screen>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
<section id="charent">
<title id="charenttitle">Charater Literals—Do's and Dont's</title>
<para>Some characters or character combinations should not be used
literally. This is because they will not be typeset in an optimal
way. Here is a list of things to watch for:
<variablelist>
<varlistentry>
<term>Quotations</term>
<listitem>
<para>Enclose quotations in the <sgmltag
class="element">quote</sgmltag> element.</para>
<para>Rather than typing, say, "He said
thus and such", type <sgmltag class="starttag">quote</sgmltag>He said
thus and such<sgmltag class="endtag">quote</sgmltag>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Horizontal Ellipsis</term>
<listitem>
<para>Use <sgmltag class="genentity">hellip</sgmltag> to produce
ellipsis.</para>
<para>Rather than typing:
<literallayout>
<![CDATA[
<quote>He said thus and such and ...</quote>
]]>
</literallayout>
type:
<![CDATA[
<quote>He said thus and such and …</quote>
]]>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Vertical Ellipsis</term>
<listitem>
<para>Use <sgmltag class="genentity">vellip</sgmltag> to produce
ellipsis.</para>
<para>Type:
<literallayout>
<![CDATA[
<para>
⋮
Above me and below me there is stuff.
⋮
</para>
]]>
</literallayout>
rather than:
<literallayout>
<![CDATA[
<para>
.
.
.
Above me and below me there is stuff.
.
.
.
</para>
]]>
</literallayout>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>En Dash</term>
<listitem>
<para>Use <sgmltag class="genentity">ndash</sgmltag> to produce an en
dash.</para>
<para>Type <quote>1<sgmltag
class="genentity">ndash</sgmltag>10</quote> rather than
<quote>1-10</quote></para>
</listitem>
</varlistentry>
<varlistentry>
<term>Em Dash</term>
<listitem>
<para>Use <sgmltag class="genentity">mdash</sgmltag> to produce an em
dash.</para>
<para>Type <quote>You stink!<sgmltag
class="genentity">mdash</sgmltag>Well, a little bit anyway</quote> rather than
<quote>You stink!---Well, a little bit anyway.</quote></para>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
</section>
<section id="sec.editdocbkdocs">
<title>Editing &dbk; Documents</title> <para>&dbk; is an XML based
language for composing techical documents. Especially documents about
computer software. The <citetitle>Installation Guide</citetitle>,
<citetitle>Developers Guide</citetitle>, and this document are
composed in the &dbk; language.</para>
<para>It is beyond the scope of this article to introduce the &dbk;
language in any detail. Please read the <ulink
url="http://docbook.org/tdg/en/html/docbook.html">online &dbk;
guide</ulink> for an introduction to &dbk;. It also provides a complete
reference to all &dbk;'s elements and attributes.
</para>
<para>You may want to peruse this document's XML source to get a feel for
the &dbk; language. It is the file
<filename>doc/Documentum/documentum.xml</filename>
</para>
<section>
<title>Single File Document</title>
<para>&dbk; documents may be contained in one file or may be segmented into
several files. A multi-file document will consist of a
<firstterm>main</firstterm> file and one or more additional file.</para>
<para>
A new single file document will look like this:
<programlisting>
<![CDATA[
<?xml version="1.0" encoding="iso-8859-1" ?>
<!DOCTYPE root-element PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd" [
<!ENTITY sr "SCIRun">
]>
<!--
The contents of this file are subject to the University of Utah Public
License (the "License"); you may not use this file except in compliance
with the License.
Software distributed under the License is distributed on an "AS IS"
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
License for the specific language governing rights and limitations under
the License.
The Original Source Code is SCIRun, released March 12, 2001.
The Original Source Code was developed by the University of Utah.
Portions created by UNIVERSITY are Copyright (C) 2001, 1994
University of Utah. All Rights Reserved.
-->
<!-- Insert root element here. -->
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-default-dtd-file:"../../doc/Utilities/XML/docbook.ced"
sgml-omittag:nil
sgml-shorttag:nil
End:
-->
]]>
</programlisting>
Where <quote>root-element</quote> should be replaced by your document's root
element, usually <sgmltag>book</sgmltag> or <sgmltag>article</sgmltag>. And
the path to <filename>docbook.ced</filename> should be altered appropriately.
</para>
</section>
<section>
<title>Multi-file Document</title>
<para>A multi-file document will consist of a main file which usually does
nothing more than <quote>include</quote> other files. Here is the main
file for a book consisting of five chapters:
<programlisting>
<![CDATA[
<?xml version="1.0"? encoding="iso-8859-1" >
<!--
The contents of this file are subject to the University of Utah Public
License (the "License"); you may not use this file except in compliance
with the License.
Software distributed under the License is distributed on an "AS IS"
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
License for the specific language governing rights and limitations under
the License.
The Original Source Code is SCIRun, released March 12, 2001.
The Original Source Code was developed by the University of Utah.
Portions created by UNIVERSITY are Copyright (C) 2001, 1994
University of Utah. All Rights Reserved.
-->
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd" [
<!ENTITY sr "SCIRun">
<!ENTITY chap1 SYSTEM "chap1.xml">
<!ENTITY chap2 SYSTEM "chap2.xml">
<!ENTITY chap3 SYSTEM "chap3.xml">
<!ENTITY chap4 SYSTEM "chap4.xml">
<!ENTITY chap5 SYSTEM "chap5.xml">
]>
<book id="main">
<title>My Great Book <title>
&chap1;
&chap2;
&chap3;
&chap4;
&chap5;
</book>
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-default-dtd-file:"../../doc/Utilities/XML/docbook.ced"
sgml-omittag:nil
sgml-shorttag:nil
End:
-->
]]>
</programlisting>
And <filename>chap1.xml</filename> would look like this:
<programlisting>
<![CDATA[
<!--
The contents of this file are subject to the University of Utah Public
License (the "License"); you may not use this file except in compliance
with the License.
Software distributed under the License is distributed on an "AS IS"
basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the
License for the specific language governing rights and limitations under
the License.
The Original Source Code is SCIRun, released March 12, 2001.
The Original Source Code was developed by the University of Utah.
Portions created by UNIVERSITY are Copyright (C) 2001, 1994
University of Utah. All Rights Reserved.
-->
<chapter>
<title>My First Chapter</title>
<section>
<title>First Section, First Chapter</title>
<para>Blah, blah, blah</para>
</section>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-default-dtd-file:"../../doc/Utilities/XML/docbook.ced"
sgml-omittag:nil
sgml-shorttag:nil
End:
-->
]]>
</programlisting>
</para>
</section>
</section>
<section id="sec.editfaqdocs">
<title>Editing FAQ Documents</title>
<para>There are currently three FAQs:
<simplelist>
<member>Installation FAQ - <filename>doc/Installation/FAQ/faq.rxml</filename></member>
<member>User FAQ - <filename>doc/User/FAQ/faq.rxml</filename></member>
<member>Developer FAQ - <filename>doc/Developer/FAQ/faq.rxml</filename></member>
</simplelist>
</para>
<para>To add a new entry to one of these FAQs (using emacs/xemacs XML mode)
do this:
<orderedlist>
<listitem>
<para>Open the appropriate file with emacs/xemacs (recommended)</para>
</listitem>
<listitem>
<para>Move point to just before the first
<sgmltag>qandaentry</sgmltag> element or just after the last
<sgmltag>qandaentry</sgmltag> element.</para>
</listitem>
<listitem>
<para>
Insert the following template at point:
<programlisting>
<![CDATA[
<qandaentry>
<revhistory>
<revision>
<revnumber></revnumber>
<date></date>
</revision>
</revhistory>
<question>
<para>
</para>
</question>
<answer>
<para>
</para>
</answer>
</qandaentry>
]]>
</programlisting>
Fill out the template (using additional DocBook markup if necessary).
</para>
</listitem>
</orderedlist>
</para>
</section>
<section id="sec.editxmlmoddocs">
<title>Editing XML Module Descriptions</title>
<para>See <ulink url="module-xml/index.html"><citetitle>XML Module
Descriptions (Explicated)</citetitle></ulink> for information on
creating/editing XML based module descriptions.</para>
</section>
<section id="sec.editltxmoddocs">
<title>Editing <x; Module Descriptions</title>
<para>See <ulink url="module-latex/index.html"><citetitle>Latex Module
Descriptions (Explicated)</citetitle></ulink> for information on
creating/editing <x; based module descriptions.</para>
</section>
<section id="sec.edithtmldocs">
<title>Editing HTML and XHTML Documents</title>
<para>First of all you
should try to avoid HTML/XHTML altogether. Try using a higher-level markup
language like &dbk; or <x;.</para>
<para>Secondly, if you must use HTML
consider using XHTML instead. XHTML is an XML formulation of HTML. It is
not yet possible or practical to write pure XHTML but as much as possible
we should be implementing our HTML-type documents using XHTML. The
following rules for composing XHTML (and HTML) documents should be
followed:
<itemizedlist>
<listitem>
<para>Use Emacs XML mode for composing XHTML documents.</para>
</listitem>
<listitem>
<para>Write tag and attribute names in lower case.</para>
</listitem>
<listitem>
<para>Enclose attribute values in quotes
(e.g. <userinput>id="sec.edithtmldocs"</userinput>)</para>
</listitem>
<listitem>
<para>Close all elements.. I.e. never omit end tags. Empty
elements should be closed by either an end tag or by ending the start tag
with <userinput>/></userinput>, e.g. the horizontal rule element should
be written as <userinput><hr/></userinput></para>
</listitem>
<listitem>
<para>Nest elements properly.</para>
</listitem>
<listitem>
<para>… and in general try to produce valid XHTML/HTML
documents.</para>
</listitem>
<listitem>
<para>Mind your character entities (see <xref endterm="charenttitle"
linkend="charent"/>).</para>
</listitem>
<listitem>
<para>Avoid presentational markup (e.g. <sgmltag
class="starttag">font</sgmltag> elements) —Use external CSS stylesheets
or the <sgmltag class="starttag">style</sgmltag> element (but avoid
the inline <literal>style</literal> attribute) instead.</para>
</listitem>
</itemizedlist>
These rules are explained more fully on the <ulink
url="http://www.w3schools.com/xhtml/xhtml_html.asp">W3Schools.com</ulink>
web site. </para>
<para>Documents which live in the <filename>doc</filename> side of the tree
should be derived from
<filename>doc/Documentum/doc_template.html</filename> and those that live
in the <filename>src</filename> side of the tree should be based on
<filename>doc/Documentum/src_template.html</filename>.</para>
</section>
<section id="sec.editltxdocs">
<title>Editing <x; Documents</title>
<para>⋮</para>
<para>Some day I need to put something here.</para>
<para>⋮</para>
</section>
</section>
<section>
<title>Publishing to SCI Web Sites</title>
<para>&sr; documentation is published to 3 SCI web sites. Each web site
serves a different purpose.</para>
<para>Documentation under development is
published on the <ulink
url="http://internal.sci.utah.edu/developer/SCIRun/doc">internal</ulink>
site.
Documentation being tested for release is published on the
<ulink url="http://software2.sci.utah.edu/doc">test</ulink> site.
Documentation for the current &sr; release is published on the
<ulink url="http://software.sci.utah.edu/doc">external</ulink>
site.
</para>
<para>The following sections describe (approximately) how to publish
documentation to these sites.</para>
<section>
<title>Publishing to SCI's Internal Web Site</title>
<para>&sr; documentation which is under development (from the
trunk of the CVS tree) is published on
SCI's internal web site. To publish docs on the internal web site do
this:
<orderedlist>
<listitem>
<para>Update your &sr; CVS tree.</para>
</listitem>
<listitem>
<para>Build the docs and create a doc tarball.</para>
</listitem>
<listitem>
<para>Copy the tarball to
<filename>/usr/sci/projects/SCIRun/docs</filename> and unpack it using
GNU tar (<command>tar zxf <tarball></command>).</para>
</listitem>
<listitem>
<para><command>Cd</command> to
<filename>/usr/sci/projects/SCIRun/docs</filename> and remove the
<filename>doc</filename> and <filename>src</filename> directories if
they exist.</para>
</listitem>
<listitem>
<para>Move the <filename>doc</filename> and <filename>src</filename>
directories from inside the directory created by unpacking the tarball
to <filename>/usr/sci/projects/SCIRun/docs</filename>.</para>
</listitem>
</orderedlist>
</para>
</section>
<section>
<title>Publishing to SCI's Test Web Site</title>
<para>SCI's test web
site is <filename>http://software2.sci.utah.edu</filename>. Use this
site to test documentation (from the release branch of the CVS tree)
prior to a software release.</para>
<para>To publish the docs on SCI's external web site do this:
<orderedlist>
<listitem>
<para>Build a doc tarball from the sources on the release branch.
Rename the tarball to reflect its release number,
e.g. <filename>SCIRunDocs-1.6.1.tar.gz</filename>.</para>
</listitem>
<listitem>
<para>Copy the doc tarball to the directory
<filename>/w01/docs/scirun-biopse</filename> on
<filename>dante.sci.utah.edu</filename>.</para>
</listitem>
<listitem>
<para>Unpack the tarball using GNU tar.</para>
</listitem>
<listitem>
<para>Rename the resulting directory to match the name of the tarball,
e.g. <filename>SCIRunDocs-1.6.1</filename>.</para>
</listitem>
<listitem>
<para><command>cd</command> to
<filename>/w01/sciweb/software</filename>.</para>
</listitem>
<listitem>
<para>Remove the symbolic links <filename>doc</filename> and <filename>src</filename>.</para>
</listitem>
<listitem>
<para>Create new symbolic links. The <filename>doc</filename> link
should point to
<filename>../../docs/scirun-biopse/<doc-directory>/doc</filename>
and the <filename>src</filename> link should point to
<filename>../../docs/scirun-biopse/<doc-directory>/src</filename>
where <filename><doc-directory></filename> is the name of
directory created (and renamed) previously. For example:</para>
<literallayout class="monospaced">
ln -s ../../docs/scirun-biopse/1.6.1/doc doc
ln -s ../../docs/scirun-biopse/1.6.1/src src
</literallayout>
</listitem>
</orderedlist>
</para>
</section>
<section>
<title>Publishing to SCI's External Web Site.</title>
<para>&sr; documentation for the current &sr; release (from the
current release branch of the CVS tree) is published to the external
web site.</para>
<para>To publish the docs on SCI's external web site do this:
<orderedlist>
<listitem>
<para>Build a doc tarball from the sources on the release branch.
Rename the tarball to as follows:
<filename>docs-<replaceable>d.d.d</replaceable>.tar.gz</filename>,
where <replaceable>d.d.d</replaceable> is the documentation version
number.</para>
</listitem>
<listitem>
<para>Copy the doc tarball to the directory
<filename>/w01/docs/scirun-biopse/present</filename> on
<filename>virgil.sci.utah.edu</filename>.</para>
</listitem>
<listitem>
<para>Unpack the tarball using GNU tar.</para>
</listitem>
<listitem>
<para>The resulting directory will contain <filename>doc</filename>
and <filename>src</filename> sub-directories. Move these
sub-directories up one level. Remove the
</listitem>
<listitem>
<para><command>Cd</command> to
<filename>/w01/sciweb/software</filename>.</para>
</listitem>
<listitem>
<para>Remove the symbolic links <filename>doc</filename> and <filename>src</filename>.</para>
</listitem>
<listitem>
<para>Create new symbolic links. The <filename>doc</filename> link
should point to
<filename>../../docs/scirun-biopse/present/doc</filename>
and the <filename>src</filename> link should point to
<filename>../../docs/scirun-biopse/present/src</filename>
For
example:</para>
<literallayout class="monospaced">
ln -s ../../docs/scirun-biopse/1.8.1/doc doc
ln -s ../../docs/scirun-biopse/1.8.1/src src
</literallayout>
</listitem>
</orderedlist>
</para>
</section>
</section>
<section id="sec.tools">
<title>Tools</title>
<para>
The following tools are
needed to build &sr; documentation:
<variablelist>
<varlistentry>
<term><ulink url="http://www.gnu.org/software/make/make.html">GNU
Make</ulink> (3.79 or later)</term>
<listitem>
<para>GNU's version of the make utility. Makefiles in the doc tree are
incompatible with other versions of the make utility.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://www.gnu.org/software/tar/tar.html">GNU
Tar</ulink> (1.12 or later)</term>
<listitem>
<para>GNU's version of tar. Tar is used to package
the documentation into a single file (tarball) for distribution. GNU
tar must be used to extract documentation from its tarball.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Java (1.3 or later)</term>
<listitem>
<para>Saxon (see below) requires the Java runtime system and libraries.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://saxon.sourceforge.net/">Saxon</ulink> (6.5.2 or later)</term>
<listitem>
<para>Saxon is an XSLT processor which applies XSL stylesheets to XML
sources to translate them to other forms (e.g. HTML). Saxon is written in
Java. Saxon is used to translate the Developers guide, the Installation
guide, the FAQ book, and the XML based module descriptions to HTML and <x;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://www.latex-project.org/"><x;</ulink></term>
<listitem>
<para><x; is a document markup language and typesetting system. The Users
guide and some module descriptions require <x;.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://www.latex2html.org">Latex2html</ulink></term>
<listitem>
<para>The latex2html tool translates <x; documents to HTML. It is used to
translate the Users guide and latex module descriptions to HTML.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://www.stack.nl/~dimitri/doxygen/">Doxygen</ulink></term>
<listitem>
<para>Doxygen is a documentation system for C++. It both generates and extracts
documentation from C++ source files.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://docbook.sourceforge.net/">&dbk; Style
Sheets</ulink> (1.51.1)</term>
<listitem>
<para>The &dbk; stylesheets translate &dbk; XML documents (Developers
guide and Installation guide) to HTML.</para>
<para>There are 3 &sr;
specific stylesheets that must be copied into the &dbk; distribution. The
files <filename>doc/Utilities/XML/srdocbook.xsl</filename>,
<filename>doc/Utilities/XML/srdocbook-common.xsl</filename>, and
<filename>doc/Utilities/XML/srdocbook-chunk.xsl</filename> must be copied
to the <filename>html</filename> directory of the &dbk;
distribution.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://www.pragmaticprogrammer.com/ruby/">Ruby</ulink> (1.6
or later)</term>
<listitem>
<para>A number of scripts in the doc tree are written in the programming language Ruby.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>ERuby (a modified version of eruby 0.9.8)</term>
<listitem>
<para>A number of XML, HTML, and <x; source documents contain
snippets of Ruby code. ERuby is a tool that produces a new document
by replacing the code with result of its execution. A modified version
of eruby 0.9.8 is used. <ulink
url="mailto:dustman＠cvrti.utah.edu">Contact me</ulink> to get the
sources. More information on these type of files can be found in <xref
endterm="sec.docmls.title" linkend="sec.docmls"/></para>
</listitem>
</varlistentry>
<varlistentry>
<term><ulink url="http://www.imagemagick.org">ImageMagick</ulink></term>
<listitem>
<para>From the ImageMagick <filename>README</filename> file: ImageMagick
<quote>...is a robust collection of tools and libraries to read, write, and
manipulate an image in any of the more popular image formats including GIF,
JPEG, PNG, PDF, and Photo CD...</quote></para>
<para>The <command>convert</command> utility from the ImageMagick package
is being used to translate jpg and gif files to eps for use in the
printable version of the users guide.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
<section id="to-do">
<title>To Do</title>
<para>The following sections present a never ending list of things to
be done.</para>
<section>
<title>User Docs</title>
<itemizedlist>
<listitem>
<para>Partially revised for &sr; 1.8. More work needed</para>
</listitem>
</itemizedlist>
</section>
<section>
<title>Developer Docs</title>
<itemizedlist>
<listitem>
<para>Needs update.</para>
</listitem>
<listitem>
<para>Convert remaining html docs to xml.</para>
</listitem>
<listitem>
<para>Get missing figures for a few xml module descriptions.</para>
</listitem>
</itemizedlist>
</section>
<section>
<title>FAQs</title>
<itemizedlist>
<listitem>
<para>FAQs are out of date. Need a volunteer to cull out the cruft.</para>
</listitem>
</itemizedlist>
</section>
<section>
<title>General</title>
<itemizedlist>
<listitem>
<para>Produce truly printable Installation and Developer Guides (how
good are the FOPs these days?). We can always use jade and jadetex.
This would require the installation of jade and the DocBook DSSSL
stylesheets.</para>
</listitem>
<listitem>
<para>Generate Makefiles via configure script. Need to check that
the proper tools are installed, etc.</para>
</listitem>
<listitem>
<para>Add section to this document on editing latex documents.</para>
</listitem>
</itemizedlist>
</section>
<section>
<title>Changes to <filename>component.dtd</filename></title>
<para>
Modify <filename>component.dtd</filename> in the following ways:
<itemizedlist>
<listitem>
<para>Replace <sgmltag class="starttag">examplesr</sgmltag> element
with the <sgmltag class="starttag">docnet</sgmltag> element as
proposed by Marty.</para>
</listitem>
<listitem>
<para>Enhance <sgmltag class="starttag">description</sgmltag> element
to allow the <sgmltag class="starttag">img</sgmltag> element.</para>
</listitem>
<listitem>
<para>Don't require that the basic flow patterns start with a <sgmltag
class="starttag">p</sgmltag> element.</para>
</listitem>
<listitem>
<para>Add <quote>id</quote> attribute to all
elements and then:</para>
<para>Replace <sgmltag class="starttag">slink</sgmltag> and <sgmltag
class="starttag">rlink</sgmltag> elements with <sgmltag
class="starttag">ulink</sgmltag> (for url style links) and <sgmltag
class="starttag">link</sgmltag> (for intra document
links).</para>
</listitem>
</itemizedlist>
</para>
</section>
</section>
</article>
<!-- Keep this comment at the end of the file
Local variables:
mode: xml
sgml-default-dtd-file:"../../doc/Utilities/XML/docbook.ced"
sgml-omittag:nil
sgml-shorttag:nil
End:
-->
================================================================
System Info to help track down your bug:
---------------------------------------
uname -a: Darwin mainserver.cvrti.utah.edu 6.2 Darwin Kernel Version 6.2: Tue Nov 5 22:00:03 PST 2002; root:xnu/xnu-344.12.2.obj~1/RELEASE_PPC Power Macintosh powerpc
./configure '--prefix=/sw' '--with-dialogs=athena' '--with-widgets=athena' '--with-sound=none' '--with-database=no' '--without-ldap' '--without-postgresql' '--with-athena=3d'
XEmacs 21.5-b9 "brussels sprouts" configured for `powerpc-apple-darwin6.2'.
Compilation / Installation:
Source code location: /sw/src/xemacs-21.5.9-3/xemacs-21.5.9
Installation prefix: /sw
Operating system description file: `s/darwin.h'
Machine description file: `m/powerpc.h'
Compiler: gcc -g -O3 -Wall -Wno-switch -Winline -Wmissing-prototypes -Wsign-compare -Wshadow -Wpointer-arith
Relocating allocator for buffers: no
GNU version of malloc: no
- The GNU allocators don't work with this system configuration.
Window System:
Compiling in support for the X window system:
- X Windows headers location: /usr/X11R6/include
- X Windows libraries location: /usr/X11R6/lib
- Handling WM_COMMAND properly.
Compiling in support for the Athena widget set:
- Athena headers location: X11/Xaw3d
- Athena library to link: Xaw3d
Using Lucid menubars.
Using Lucid scrollbars.
Using Athena dialog boxes.
Using Athena native widgets.
TTY:
Compiling in support for ncurses.
Images:
Compiling in support for GIF images (builtin).
Compiling in support for XPM images.
Compiling in support for PNG images.
Compiling in support for JPEG images.
Compiling in support for TIFF images.
Sound:
Databases:
Internationalization:
Mail:
Compiling in support for "dot-locking" mail spool file locking method.
Other Features:
Inhibiting IPv6 canonicalization at startup.
Compiling in support for dynamic shared object modules.
Using the new portable dumper.
Compiling in support for extra debugging code.
WARNING: ---------------------------------------------------------
WARNING: Compiling in support for runtime error checking.
WARNING: XEmacs will run noticeably more slowly as a result.
WARNING: Error checking is on by default for XEmacs beta releases.
WARNING: ---------------------------------------------------------
Load-Path Lisp Shadows:
----------------------
(/sw/lib/xemacs/xemacs-packages/lisp/ecrypto/md5
/sw/lib/xemacs/xemacs-packages/lisp/gnus/md5)
Installed XEmacs Packages:
-------------------------
((zenirc:version 1.13 :type regular)
(xslt-process :version 1.1 :type regular)
(xslide :version 1.03 :type regular)
(xemacs-devel :version 1.48 :type single-file)
(xemacs-base :version 1.68 :type regular)
(w3 :version 1.25 :type regular)
(vm :version 7.07 :type regular)
(viper :version 1.34 :type regular)
(view-process :version 1.12 :type regular)
(vhdl :version 1.15 :type regular)
(vc-cc :version 1.21 :type regular)
(vc :version 1.33 :type regular)
(tramp :version 1.08 :type regular)
(tpu :version 1.12 :type regular)
(tooltalk :version 1.13 :type regular)
(tm :version 1.34 :type regular)
(time :version 1.12 :type regular)
(textools :version 1.12 :type regular)
(text-modes :version 1.52 :type single-file)
(texinfo :version 1.2 :type regular)
(supercite :version 1.19 :type regular)
(strokes :version 1.08 :type regular)
(speedbar :version 1.24 :type regular)
(sounds-wav :version 1.1 :type regular)
(sounds-au :version 1.1 :type regular)
(sml-mode :version 0.03 :type regular)
(slider :version 1.13 :type regular)
(sieve :version 1.09 :type regular)
(sh-script :version 1.15 :type regular)
(sgml :version 1.08 :type regular)
(semantic :version 1.14 :type regular)
(scheme :version 1.11 :type regular)
(sasl :version 1.12 :type regular)
(rmail :version 1.13 :type regular)
(reftex :version 1.28 :type regular)
(psgml-dtds :version 1.02 :type regular)
(psgml :version 1.33 :type regular)
(ps-print :version 1.08 :type regular)
(prog-modes
:version
1
.65
:type
single-file)
(pcomplete :version 1.01 :type regular)
(pcl-cvs :version 1.64 :type regular)
(pc :version 1.25 :type single-file)
(os-utils :version 1.28 :type single-file)
(ocaml :version 0.03 :type regular)
(net-utils :version 1.28 :type single-file)
(mmm-mode :version 1.0 :type regular)
(misc-games :version 1.15 :type single-file)
(mine :version 1.14 :type regular)
(mh-e :version 1.15 :type regular)
(mew :version 1.17 :type regular)
(mailcrypt :version 2.11 :type regular)
(mail-lib :version 1.49 :type regular)
(liece :version 1.07 :type regular)
(jde :version 1.35 :type regular)
(ispell :version 1.24 :type regular)
(ilisp :version 1.28 :type regular)
(igrep :version 1.09 :type regular)
(idlwave :version 1.25 :type regular)
(ibuffer :version 1.08 :type regular)
(hm--html-menus :version 1.18 :type regular)
(haskell-mode :version 1.03 :type regular)
(gnus :version 1.62 :type regular)
(gnats :version 1.15 :type regular)
(games :version 1.13 :type regular)
(fsf-compat :version 1.11 :type single-file)
(frame-icon :version 1.09 :type regular)
(forms :version 1.14 :type regular)
(footnote :version 1.15 :type regular)
(eudc :version 1.36 :type regular)
(eterm :version 1.13 :type regular)
(ess :version 1.02 :type regular)
(eshell :version 1.03 :type regular)
(emerge :version 1.09 :type regular)
(elib :version 1.1 :type single-file)
(eieio :version 1.03 :type regular)
(efs :version 1.29 :type regular)
(edt :version 1.12 :type regular)
(edit-utils :version 1.93 :type single-file)
(ediff :version 1.41 :type regular)
(edebug :version 1.14 :type regular)
(ecrypto :version 0.11 :type regular)
(docbookide :version 0.05 :type regular)
(dired :version 1.12 :type regular)
(dictionary :version 1.11 :type regular)
(debug :version 1.15 :type regular)
(crisp :version 1.12 :type regular)
(cookie :version 1.14 :type regular)
(clearcase :version 1.04 :type regular)
(cc-mode :version 1.3 :type regular)
(calendar :version 1.18 :type regular)
(calc :version 1.23 :type regular)
(c-support :version 1.16 :type single-file)
(build :version 1.07 :type regular)
(bbdb :version 1.21 :type regular)
(auctex :version 1.32 :type regular)
(apel :version 1.25 :type regular)
(ada :version 1.1 :type regular))
Features:
--------
(mail-abbrevs xemacsbug shadow sendmail rfc822 font disp-table paren
blink-paren pending-del func-menu view-less view efs-ovwrt default-dir
gnuserv mwheel tex-site font-lock cus-face tramp regexp-opt advice
advice-preload shell comint ring format-spec timer zenirc-autoloads
xslt-process-autoloads xslide-autoloads xemacs-devel-autoloads
xemacs-base-autoloads w3-autoloads vm-autoloads viper-autoloads
view-process-autoloads vhdl-autoloads vc-cc-autoloads vc-autoloads
tramp-autoloads tpu-autoloads tooltalk-autoloads tm-autoloads
time-autoloads textools-autoloads text-modes-autoloads texinfo-autoloads
supercite-autoloads strokes-autoloads speedbar-autoloads
sounds-wav-autoloads sounds-au-autoloads sml-mode-autoloads
slider-autoloads sieve-autoloads sh-script-autoloads sgml-autoloads
semantic-autoloads scheme-autoloads sasl-autoloads rmail-autoloads
reftex-autoloads psgml-dtds-autoloads psgml-autoloads ps-print-autoloads
prog-modes-autoloads pcomplete-autoloads pcl-cvs-autoloads pc-autoloads
os-utils-autoloads ocaml-autoloads net-utils-autoloads mmm-mode-autoloads
misc-games-autoloads mine-autoloads mh-e-autoloads mew-autoloads
mailcrypt-autoloads mail-lib-autoloads liece-autoloads jde-autoloads
ispell-autoloads ilisp-autoloads igrep-autoloads idlwave-autoloads
ibuffer-autoloads hm--html-menus-autoloads haskell-mode-autoloads
gnus-autoloads gnats-autoloads games-autoloads fsf-compat-autoloads
frame-icon-autoloads forms-autoloads footnote-autoloads eudc-autoloads
eterm-autoloads ess-autoloads eshell-autoloads emerge-autoloads
elib-autoloads eieio-autoloads efs-autoloads edt-autoloads
edit-utils-autoloads ediff-autoloads edebug-autoloads ecrypto-autoloads
docbookide-autoloads dired-autoloads dictionary-autoloads debug-autoloads
crisp-autoloads cookie-autoloads clearcase-autoloads cc-mode-autoloads
calendar-autoloads calc-autoloads c-support-autoloads build-autoloads
bbdb-autoloads auctex-autoloads apel-autoloads ada-autoloads src-autoloads
loadhist rsz-minibuf auto-show fontl-hooks x-iso8859-1 code-cmds
gutter-items menubar-items x-menubar mode-motion mouse behavior itimer
auto-save lisp-mode easymenu iso8859-1 page buff-menu lib-complete cus-file
derived env text-props frame obsolete cus-start custom widget cl-extra
mini-cl cl cl-19 packages backquote very-early-lisp unicode
lucid-scrollbars cut-buffer lucid-menubars athena-dialogs x c-balloon-help
tty-frames tty toolbar scrollbar unix-processes multicast network-streams
subprocesses modules menu-accelerator-support menubar md5 xemacs gutter
tiff png gif jpeg xpm xbm lisp-float-type file-coding darwin dialog devices
window-system base64)
Recent keystrokes:
-----------------
button1 button1up C-x 1 M-x v e r TAB button2 button2up
C-n ( v e r s i o n ) C-j misc-user
Recent messages (most recent first):
-----------------------------------
Loading xemacsbug...done (file xemacsbug.el is newer)
Loading xemacsbug... (file xemacsbug.el is newer)
XEmacs 21.5 (beta9) "brussels sprouts" [Lucid] (powerpc-apple-darwin6.2) of Fri Nov 29 2002 on mainserver.cvrti.utah.edu
Making completion list...
Warning: XEmacs: Mod1 is being used for both Mode_switch and Alt.
Warning:
Two distinct modifier keys (such as Meta and Hyper) cannot generate
the same modifier bit, because Emacs won't be able to tell which
modifier was actually held down when some other key is pressed. It
won't be able to tell Meta-x and Hyper-x apart, for example. Change
one of these keys to use some other modifier bit. If you intend for
these keys to have the same behavior, then change them to have the
same keysym as well as the same modifier bit.
Warning:
The meanings of the modifier bits Mod1 through Mod5 are determined
by the keysyms used to control those bits. Mod1 does NOT always
mean Meta, although some non-ICCCM-compliant programs assume that.
Loading font...done
Loading font...
Paren mode is paren
Loading paren...done
Loading paren...
Loading /private/var/netboot/Users/dustman/.emacs.d/rgstrs.el...done
Loading /private/var/netboot/Users/dustman/.emacs.d/rgstrs.el...
Loading gnuserv...done
Loading gnuserv...
Loading mwheel...done
Loading mwheel...
Loading /sw/lib/xemacs/xemacs-packages/lisp/auctex/tex-site.el...done
Loading /sw/lib/xemacs/xemacs-packages/lisp/auctex/tex-site.el...
- 1 participants
- 0 comments
[21.5.10] Win32 build experiences
21 years, 11 months
Schmitt, Christian (ext.)
Schmitt, Christian (ext.)
Hi,
I've been compiling XEmacs for the first time on Win32 in
the last coupleof days.
It went quite OK for the most part. Here are some things that
occurred to me:
- During compilation of the C code MS compiler keeps
spitting out this warning:
D:\xemacs-21.5\nt\..\src\text.h(42) : warning C4273: 'strlwr' :
Inkonsistente DLL-Bindung. dllexport angenommen.
D:\xemacs-21.5\nt\..\src\text.h(45) : warning C4273: 'strupr' :
Inkonsistente DLL-Bindung. dllexport angenommen.
This translates to: Inconsistent DLL binding. dllexport assumed.
But compilation succeeds and XEmacs seems to be running OK.
Using depends.exe I saw that my self-compiled XEmacs exports
the two functions strlwr and strupr whereas my pre-compiled
21.4.11 does not.
- The other thing is that while I was compiling on Win2K (SP2)
I was not able to run the resulting exe on WinNT 4.0 due to
a function GetLongPathNameW that is not present in NT but is
in Win98 and Win2K. I applied the patch mentioned here
http://list-archive.xemacs.org/xemacs-nt/200207/msg00021.html
and now the exe is starting on WinNT as well.
Thanks for a great product!
Cheers,
Christian Schmitt
- 3 participants
- 3 comments
Crash when quitting ediff-regions-wordwise
21 years, 11 months
Jonas Arvidsson
Jonas Arvidsson
This bug report will be sent to the XEmacs Development Team,
not to your local site managers!!
Please write in English, because the XEmacs maintainers do not have
translators to read other languages for them.
Please describe as succinctly as possible:
- What happened.
- What you thought should have happened.
- Precisely what you were doing at the time.
Please also include any C or lisp back-traces that you may have.
================================================================
Dear Bug Team!
When qutting an ediff-regions-wordwise or ediff-regions-linewise
session on two regions in the same buffer, I get a crash. Here are the
C and Lisp backtraces:
(gdb) bt
#0 0xfeb1c840 in _libc_kill () from /usr/lib/libc.so.1
#1 0x00079c90 in fatal_error_signal ()
#2 <signal handler called>
#3 0xfeb1c840 in _libc_kill () from /usr/lib/libc.so.1
#4 0xfeab5a74 in abort () from /usr/lib/libc.so.1
#5 0x0007bb10 in assert_failed ()
#6 0x000849a0 in signal_1 ()
#7 0x0007dab8 in Fsignal ()
#8 0x0007e16c in error ()
#9 0x0012a928 in marker_position ()
#10 0x00121774 in buffer_line_number ()
#11 0x0013e254 in decode_mode_spec ()
#12 0x0013d2a0 in generate_fstring_runes ()
#13 0x0013cbd8 in generate_fstring_runes ()
#14 0x0013c7d4 in generate_formatted_string_db ()
#15 0x00148990 in generate_modeline ()
#16 0x0014566c in ensure_modeline_generated ()
#17 0x00146688 in regenerate_window ()
#18 0x00146f40 in redisplay_window ()
#19 0x0013db7c in redisplay_frame ()
#20 0x001479f0 in redisplay_device ()
#21 0x00148004 in redisplay_without_hooks ()
#22 0x000aaec0 in Fnext_event ()
#23 0x0005f8ec in Fcommand_loop_1 ()
#24 0x0007d750 in condition_case_1 ()
#25 0x0005fdb4 in command_loop_2 ()
#26 0x0007d614 in internal_catch ()
#27 0x0005f588 in initial_command_loop ()
#28 0x0007ad70 in xemacs_21_4_12_sparc_sun_solaris2_7 ()
#29 0x0007b58c in main ()
Lisp backtrace follows:
# (condition-case ... . error)
# (catch top-level ...)
Best Regards,
Jonas Arvidsson
TietoEnator
Karlstad, Sweden
================================================================
System Info to help track down your bug:
---------------------------------------
uname -a: SunOS solstal 5.7 Generic_106541-20 sun4u sparc SUNW,Ultra-4
./configure '--prefix=/home/pub/SOLARIS/applications/xemacs/21.4' '--x-includes=/home/pub/SOLARIS/include' '--x-libraries=/home/pub/SOLARIS/lib' '--with-tooltalk=yes' '--error-checking=none' '--cflags=-O3' '--with-workshop' '--debug=no' '--infopath=/home/pub/SOLARIS/info' '--with-mule=no' '--with-sound=native'
XEmacs 21.4.12 "Portable Code" configured for `sparc-sun-solaris2.7'.
Compilation / Installation:
Source code location: /tmp/xemacs-21.4.12
Installation prefix: /home/pub/SOLARIS/applications/xemacs/21.4
Runtime library search path: /usr/ccs/lib:/usr/dt/lib:/home/pub/SOLARIS/lib:/home/pub/SOLARIS/applications/gcc/3.2/lib/gcc-lib/sparc-sun-solaris2.7/3.2
Operating system description file: `s/sol2.h'
Machine description file: `m/sparc.h'
Compiler: gcc -O3
Relocating allocator for buffers: yes
GNU version of malloc: yes
Window System:
Compiling in support for the X window system:
- X Windows headers location: /usr/dt/include /home/pub/SOLARIS/include
- X Windows libraries location: /usr/dt/lib /home/pub/SOLARIS/lib
- Handling WM_COMMAND properly.
Using Lucid menubars.
Using Lucid scrollbars.
Using Motif dialog boxes.
Using Motif native widgets.
TTY:
Compiling in support for ncurses.
Images:
Compiling in support for GIF images (builtin).
Compiling in support for XPM images.
Compiling in support for PNG images.
Compiling in support for JPEG images.
Compiling in support for TIFF images.
Sound:
Compiling in support for sound (native).
Databases:
Compiling in support for DBM.
Compiling in support for LDAP.
Internationalization:
Mail:
Compiling in support for "dot-locking" mail spool file locking method.
Other Features:
Inhibiting IPv6 canonicalization at startup.
Compiling in support for ToolTalk.
Compiling in support for Sun WorkShop.
Compiling in support for dynamic shared object modules.
Load-Path Lisp Shadows:
----------------------
nil
Installed XEmacs Packages:
-------------------------
((zenirc:version 1.13 :type regular)
(xslt-process :version 1.11 :type regular)
(xslide :version 1.03 :type regular)
(xemacs-devel :version 1.48 :type single-file)
(xemacs-base :version 1.71 :type regular)
(w3 :version 1.26 :type regular)
(vm :version 7.07 :type regular)
(viper :version 1.35 :type regular)
(view-process :version 1.12 :type regular)
(vhdl :version 1.15 :type regular)
(vc-cc :version 1.21 :type regular)
(vc :version 1.33 :type regular)
(tramp :version 1.1 :type regular)
(tpu :version 1.12 :type regular)
(tooltalk :version 1.13 :type regular)
(tm :version 1.34 :type regular)
(time :version 1.12 :type regular)
(textools :version 1.13 :type regular)
(text-modes :version 1.55 :type single-file)
(texinfo :version 1.21 :type regular)
(supercite :version 1.19 :type regular)
(strokes :version 1.08 :type regular)
(speedbar :version 1.24 :type regular)
(sounds-wav :version 1.1 :type regular)
(sounds-au :version 1.1 :type regular)
(sml-mode :version 0.05 :type regular)
(slider :version 1.13 :type regular)
(sieve :version 1.1 :type regular)
(sh-script :version 1.16 :type regular)
(sgml :version 1.08 :type regular)
(semantic :version 1.14 :type regular)
(scheme :version 1.12 :type regular)
(sasl :version 1.12 :type regular)
(ruby-modes :version 1.0 :type single-file)
(rmail :version 1.13 :type regular)
(reftex :version 1.28 :type regular)
(python-modes :version 1.01 :type single-file)
(psgml-dtds :version 1.02 :type regular)
(psgml :version 1.35 :type regular)
(ps-print :version 1.08 :type regular)
(prog-modes
:version
1
.67
:type
single-file)
(pgg :version 1.01 :type regular)
(perl-modes :version 1.02 :type single-file)
(pcomplete :version 1.02 :type regular)
(pcl-cvs :version 1.64 :type regular)
(pc :version 1.25 :type single-file)
(os-utils :version 1.29 :type single-file)
(ocaml :version 0.03 :type regular)
(net-utils :version 1.28 :type single-file)
(mmm-mode :version 1.0 :type regular)
(misc-games :version 1.15 :type single-file)
(mine :version 1.14 :type regular)
(mh-e :version 1.16 :type regular)
(mew :version 1.17 :type regular)
(mailcrypt :version 2.12 :type regular)
(mail-lib :version 1.54 :type regular)
(liece :version 1.1 :type regular)
(jde :version 1.38 :type regular)
(ispell :version 1.24 :type regular)
(ilisp :version 1.28 :type regular)
(igrep :version 1.1 :type regular)
(idlwave :version 1.27 :type regular)
(ibuffer :version 1.08 :type regular)
(hm--html-menus :version 1.18 :type regular)
(haskell-mode :version 1.03 :type regular)
(gnus :version 1.64 :type regular)
(gnats :version 1.15 :type regular)
(games :version 1.13 :type regular)
(fsf-compat :version 1.11 :type single-file)
(frame-icon :version 1.09 :type regular)
(fortran-modes :version 1.01 :type single-file)
(forms :version 1.14 :type regular)
(footnote :version 1.15 :type regular)
(eudc :version 1.36 :type regular)
(eterm :version 1.13 :type regular)
(ess :version 1.02 :type regular)
(eshell :version 1.03 :type regular)
(emerge :version 1.09 :type regular)
(elib :version 1.1 :type single-file)
(eieio :version 1.03 :type regular)
(efs :version 1.29 :type regular)
(edt :version 1.12 :type regular)
(edit-utils :version 1.95 :type single-file)
(ediff :version 1.44 :type regular)
(edebug :version 1.14 :type regular)
(ecrypto :version 0.12 :type regular)
(docbookide :version 0.05 :type regular)
(dired :version 1.12 :type regular)
(dictionary :version 1.11 :type regular)
(debug :version 1.16 :type regular)
(crisp :version 1.12 :type regular)
(cookie :version 1.14 :type regular)
(clearcase :version 1.04 :type regular)
(cc-mode :version 1.31 :type regular)
(calendar :version 1.19 :type regular)
(calc :version 1.23 :type regular)
(c-support :version 1.16 :type single-file)
(build :version 1.07 :type regular)
(bbdb :version 1.21 :type regular)
(auctex :version 1.32 :type regular)
(apel :version 1.25 :type regular)
(ada :version 1.11 :type regular))
Features:
--------
(mail-abbrevs xemacsbug shadow font disp-table lazy-shot lazy-lock
font-lock w3-cus url mm mule-sysdp url-parse url-vars xml-parse
doxymacs func-menu paren blink-paren cus-edit cus-load lpr pp uniquify
ss7_java ss7_c workshop eserve env filladapt tcl dm_ss7 dmacro
clearcase timer tq dired-faces dired-xemacs dired comint ring
pending-del time align follow advice advice-preload reporter sendmail
rfc822 tempo psgml-xemacs sgml-mode psgml psgml-html cwarn cc-mode
cc-align cc-cmds cc-engine cc-styles cc-langs cc-vars wid-edit
cc-menus imenu cc-defs xemacs-font-lock-fix cus-face edmacro
zenirc-autoloads xslt-process-autoloads xslide-autoloads
xemacs-devel-autoloads xemacs-base-autoloads w3-autoloads vm-autoloads
viper-autoloads view-process-autoloads vhdl-autoloads vc-cc-autoloads
vc-autoloads tramp-autoloads tpu-autoloads tooltalk-autoloads
tm-autoloads time-autoloads textools-autoloads text-modes-autoloads
texinfo-autoloads supercite-autoloads strokes-autoloads
speedbar-autoloads sounds-wav-autoloads sounds-au-autoloads
sml-mode-autoloads slider-autoloads sieve-autoloads
sh-script-autoloads sgml-autoloads semantic-autoloads scheme-autoloads
sasl-autoloads ruby-modes-autoloads rmail-autoloads reftex-autoloads
python-modes-autoloads psgml-dtds-autoloads psgml-autoloads
ps-print-autoloads prog-modes-autoloads pgg-autoloads
perl-modes-autoloads pcomplete-autoloads pcl-cvs-autoloads
pc-autoloads os-utils-autoloads ocaml-autoloads net-utils-autoloads
mmm-mode-autoloads misc-games-autoloads mine-autoloads mh-e-autoloads
mew-autoloads mailcrypt-autoloads mail-lib-autoloads liece-autoloads
jde-autoloads ispell-autoloads ilisp-autoloads igrep-autoloads
idlwave-autoloads ibuffer-autoloads hm--html-menus-autoloads
haskell-mode-autoloads gnus-autoloads gnats-autoloads games-autoloads
fsf-compat-autoloads frame-icon-autoloads fortran-modes-autoloads
forms-autoloads footnote-autoloads eudc-autoloads eterm-autoloads
ess-autoloads eshell-autoloads emerge-autoloads elib-autoloads
eieio-autoloads efs-autoloads edt-autoloads edit-utils-autoloads
ediff-autoloads edebug-autoloads ecrypto-autoloads
docbookide-autoloads dired-autoloads dictionary-autoloads
debug-autoloads crisp-autoloads cookie-autoloads clearcase-autoloads
cc-mode-autoloads calendar-autoloads calc-autoloads
c-support-autoloads build-autoloads bbdb-autoloads auctex-autoloads
apel-autoloads ada-autoloads lisp-autoloads loadhist auto-show
fontl-hooks x-iso8859-1 gutter-items menubar-items x-menubar
mode-motion mouse itimer auto-save lisp-mode easymenu iso8859-1 page
buff-menu lib-complete help-nomule cus-file derived frame text-props
obsolete cus-start custom widget cl-extra mini-cl cl cl-19 packages
backquote very-early-lisp sparcworks tooltalk lucid-scrollbars
cut-buffer lucid-menubars motif-dialogs x c-balloon-help tty-frames
tty toolbar native-sound scrollbar unix-processes multicast
network-streams subprocesses modules menu-accelerator-support menubar
dbm md5 xemacs gutter tiff png gif jpeg xpm xbm lisp-float-type
usg-unix-v dialog devices window-system base64)
Recent keystrokes:
-----------------
C-f10 misc-user
Recent messages (most recent first):
-----------------------------------
Parsing /home/einjarv/.mailrc...
Loading xemacsbug...done
Loading xemacsbug...
Reading view properties...done
waiting for cleartool to start...done
waiting for cleartool to start...
Reading view properties...
Loading font...done
Loading font...
Paren mode is paren
Loading lazy-shot...done
Loading lazy-shot...
Loading lazy-lock...done
Loading lazy-lock...
Loading ~/.xemacs/jarv_override.el...done
Loading ~/.xemacs/jarv_override.el...
Loading ~portss7/xemacs/ss7.el...done
Paren mode is sexp
Loading paren...done
Loading paren...
- 2 participants
- 1 comments
problems building from cvs
21 years, 11 months
Adam Duck
Adam Duck
I have some problems here. This is "FreeBSD 5.0-RC3 FreeBSD 5.0-RC3 #0:
root＠cypress:/usr/obj/usr/src/sys/GENERIC i386" with "gcc version
3.2.1 [FreeBSD] 20021119 (release)". The error I'm getting is:
gmake[1]: Entering directory `/common/usr/home/duke42/src/xemacs/src'
gcc -c -Wall -Wno-switch -Winline -Wmissing-prototypes -Wsign-compare
-Wundef -Wstrict-prototypes -Wpacked -Wshadow -Wmissing-declarations
-Wpointer-arith -g -O3 -Demacs -I. -DHAVE_CONFIG_H
-I/usr/X11R6/include -I/usr/local/include -I/usr/X11R6/include alloc.c
alloc.c: In function `mark_with_description':
alloc.c:3216: `obj' undeclared (first use in this function)
alloc.c:3216: (Each undeclared identifier is reported only once
alloc.c:3216: for each function it appears in.)
alloc.c:3216: `allow_free' undeclared (first use in this function)
alloc.c:3216: warning: left-hand operand of comma expression has no effect
alloc.c:3216: syntax error before "mark_object"
alloc.c:3217: void value not ignored as it ought to be
alloc.c:3235: warning: left-hand operand of comma expression has no effect
alloc.c:3235: syntax error before "mark_object"
alloc.c:3279: warning: left-hand operand of comma expression has no effect
alloc.c:3279: syntax error before "mark_object"
gmake[1]: *** [alloc.o] Error 1
gmake[1]: Leaving directory `/common/usr/home/duke42/src/xemacs/src'
gmake: *** [src] Error 2
Can someone tell me what's wrong?
Bye, Adam.
--
Adam Duck (duck(a)cs.uni-frankfurt.de)
Bockenheimer Landstr. 135 / Zi. 211
60325 Frankfurt/Main
______________________________________
Klingon multitasking systems do not support "time-sharing". When a
Klingon program wants to run, it challenges the scheduler in
hand-to-hand combat and owns the machine.
--- Klingon Programmer
- 2 participants
- 2 comments
Cannot compile xemacs 21.5.10 on Solaris 2.7 - temacs core dumps
21 years, 11 months
Aaron Williams
Aaron Williams
Output from make:
make[1]: Entering directory `/home/aaronw/ftp/gnu/xemacs-21.5.10/src'
./temacs -nd -no-packages -batch -l
/home/aaronw/ftp/gnu/xemacs-21.5.10/src/../lisp/update-elc.el
make[1]: *** [update-elc.stamp] Segmentation Fault (core dumped)
make[1]: Leaving directory `/home/aaronw/ftp/gnu/xemacs-21.5.10/src'
make: *** [src] Error 2
Stack trace from gdb:
#0 0x00131e88 in Fmemq (elt=4358116, list=0) at fns.c:1398
1398 EXTERNAL_LIST_LOOP_3 (list_elt, list, tail)
(gdb) bt
#0 0x00131e88 in Fmemq (elt=4358116, list=0) at fns.c:1398
#1 0x0013b1e0 in Fprovide (feature=4358116) at fns.c:3542
#2 0x0011a320 in syms_of_file_coding () at file-coding.c:4606
#3 0x000b43f0 in xemacs_21_5_b10_sparc_sun_solaris2_7 (argc=6,
argv=0xffbeed84, envp=0xffbeeda0, restart=0) at emacs.c:1370
#4 0x000b63f4 in main (argc=6, argv=0xffbeed84, envp=0xffbeeda0)
at emacs.c:2719
Configure options:
./configure --prefix=/tools/kde/gnu --with-cde --memory-usage-stats
--with-default-eol-detection --with-workshop
--site-prefixes=/tools/qt/share
Platform: Solaris 2.7 on Ultrasparc
Compiler: GCC 2.95.3
Output from configure:
XEmacs 21.5-b10 "burdock" configured for `sparc-sun-solaris2.7'.
Compilation / Installation:
Source code location:
/home/aaronw/ftp/gnu/xemacs-21.5.10
Installation prefix: /tools/kde/gnu
Additional prefixes: /tools/qt/share
Runtime library search path:
/usr/ccs/lib:/tools/qt/share/lib:/usr/dt/lib:/usr/openwin/lib:/tools/NET/lib:/tools/workshop/sun5/lib:/tools/atmlocal/tcl/tcl7.6/lib:/work/engtest/ATM/SMB/lib3.10/lib:/tools/kde/gnu/lib:/home/aaronw/gnu/lib:/tools/kde/gnu/lib/gcc-lib/sparc-sun-solaris2.7/2.95.3
Operating system description file: `s/sol2.h'
Machine description file: `m/sparc.h'
Compiler: /tools/kde/gnu/bin/gcc -Wall
-Wno-switch -Winline -Wmissing-prototypes -Wsign-compare -Wundef
-Wstrict-prototypes -Wshadow -Wmissing-declarations -Wpointer-arith
-g -I/tools/qt/share/include -L/tools/qt/share/lib
Relocating allocator for buffers: yes
GNU version of malloc: yes
Linking with `-z nocombreloc'.
- Consider configuring with --pdump.
Window System:
Compiling in support for the X window system:
- X Windows headers location: /usr/dt/include
/usr/openwin/include
- X Windows libraries location: /usr/dt/lib
/usr/openwin/lib
- Handling WM_COMMAND properly.
Using Lucid menubars.
Using Lucid scrollbars.
Using Motif dialog boxes.
Using Motif native widgets.
TTY:
Compiling in support for ncurses.
Images:
Compiling in support for GIF images (builtin).
Compiling in support for XPM images.
Compiling in support for PNG images.
Compiling in support for JPEG images.
Compiling in support for TIFF images.
Sound:
Compiling in support for sound (native).
Databases:
Compiling in support for GNU DBM.
Compiling in support for LDAP.
Internationalization:
Mail:
Compiling in support for "dot-locking" mail spool file locking
method.
Other Features:
Inhibiting IPv6 canonicalization at startup.
Compiling in support for ToolTalk.
Compiling in support for Sun WorkShop.
Compiling in support for dynamic shared object modules.
Compiling in support for extra debugging code.
WARNING: ---------------------------------------------------------
WARNING: Compiling in support for runtime error checking.
WARNING: XEmacs will run noticeably more slowly as a result.
WARNING: Error checking is on by default for XEmacs beta releases.
WARNING: ---------------------------------------------------------
Appending "Makefile.in" to $ac_output_files
Appending "lib-src/Makefile.in" to $ac_output_files
Appending "lwlib/Makefile.in" to $ac_output_files
Appending
"modules/ldap/Makefile.in:modules/ldap/Makefile.in.in:modules/common/Makefile.common"
to $ac_output_files
Appending "src/Makefile.in:src/Makefile.in.in:src/depend" to
$ac_output_files
Appending "lib-src/ellcc.h" to $ac_output_files
Let me know if more information is needed. I couldn't compile 21.5.9
either.
-Aaron
- 2 participants
- 8 comments