comparison man/w3.texi @ 26:441bb1e64a06 r19-15b96

Import from CVS: tag r19-15b96
author cvs
date Mon, 13 Aug 2007 08:51:32 +0200
parents 4103f0995bd7
children ec9a17fef872
comparison
equal deleted inserted replaced
25:383a494979f8 26:441bb1e64a06
69 are preserved on all copies. 69 are preserved on all copies.
70 70
71 @end titlepage 71 @end titlepage
72 @page 72 @page
73 @ifinfo 73 @ifinfo
74 @node Top, Getting Started,, (DIR) 74 @node Top, Getting Started, (dir), (dir)
75 @top W3
76
75 Users can browse the World Wide Web from within Emacs by using Emacs-W3. 77 Users can browse the World Wide Web from within Emacs by using Emacs-W3.
76 All of the widely used (and even some not very widely used) @sc{url} 78 All of the widely used (and even some not very widely used) @sc{url}
77 schemes are supported, and it is very easy to add new methods as the 79 schemes are supported, and it is very easy to add new methods as the
78 need arises. 80 need arises.
79 81
81 from any program in Emacs. Users and other package writers are 83 from any program in Emacs. Users and other package writers are
82 encouraged to @i{Web-enable} their applications and daily work routines 84 encouraged to @i{Web-enable} their applications and daily work routines
83 with the library. 85 with the library.
84 86
85 Emacs-W3 is completely customizable, both from Emacs-Lisp and from 87 Emacs-W3 is completely customizable, both from Emacs-Lisp and from
86 stylesheets @xref{Style Sheets} If there is any aspect of Emacs-W3 that 88 stylesheets @xref{Stylesheets} If there is any aspect of Emacs-W3 that
87 cannot be modified to your satisfaction, please send mail to the 89 cannot be modified to your satisfaction, please send mail to the
88 @t{w3-beta@@indiana.edu} mailing list with any suggestions. 90 @t{w3-beta@@indiana.edu} mailing list with any suggestions.
89 @xref{Reporting Bugs} 91 @xref{Reporting Bugs}
90 92
91 @menu 93 @menu
92 * Getting Started:: Getting up and running with Emacs-W3 94 * Getting Started:: Getting up and running with Emacs-W3
93 * Basic Usage:: Basic movement and usage of Emacs-W3. 95 * Basic Usage:: Basic movement and usage of Emacs-W3.
94 * Compatibility:: Explanation of compatibility with 96 * Compatibility:: Explanation of compatibility with
95 other browsers. 97 other browsers.
96 * Stylesheets:: How to control the look of web pages 98 * Stylesheets:: How to control the look of web pages
97 * Supported URLs:: What @sc{URL} schemes are supported. 99 * Supported URLs:: What @sc{URL} schemes are supported.
98 * MIME Support:: Support for @sc{mime} 100 * MIME Support:: Support for @sc{mime}
99 * Security:: Various security methods supported 101 * Security:: Various security methods supported
100 * Non-Unix Operating Systems:: Special considerations necessary to get 102 * Non-Unix Operating Systems:: Special considerations necessary to get
101 up and running correctly under non-unix 103 up and running correctly under non-unix
102 OS's. 104 OS's.
103 * Speech Integration:: Outputting to a speech synthesizer. 105 * Speech Integration:: Outputting to a speech synthesizer.
104 * Advanced Features:: Some of the more arcane features. 106 * Advanced Features:: Some of the more arcane features.
105 * More Help:: How to get more help---mailing lists, 107 * More Help:: How to get more help---mailing lists,
142 * Preferences Panel:: Quick configuration of common options. 144 * Preferences Panel:: Quick configuration of common options.
143 @end menu 145 @end menu
144 146
145 @node Downloading, Building and Installing, Getting Started, Getting Started 147 @node Downloading, Building and Installing, Getting Started, Getting Started
146 @section Downloading 148 @section Downloading
149
147 :: WORK :: What you need, and why 150 :: WORK :: What you need, and why
148 :: WORK :: Where to download Emacs, XEmacs, various platforms 151 :: WORK :: Where to download Emacs, XEmacs, various platforms
149 :: WORK :: Where to download Emacs-W3 152 :: WORK :: Where to download Emacs-W3
150 :: WORK :: Where to download related utilities (netpbm, xv, gimp, etc.) 153 :: WORK :: Where to download related utilities (netpbm, xv, gimp, etc.)
151 154
152 @node Building and Installing, Startup Files, Downloading, Getting Started 155 @node Building and Installing, Startup Files, Downloading, Getting Started
153 @section Building and Installing 156 @section Building and Installing
157
154 :: WORK :: Document makefile variables 158 :: WORK :: Document makefile variables
155 :: WORK :: Document what gets installed where, why 159 :: WORK :: Document what gets installed where, why
156 160
157 @node Startup Files, Preferences Panel, Building and Installing, Getting Started 161 @node Startup Files, Preferences Panel, Building and Installing, Getting Started
158 @section Startup Files 162 @section Startup Files
159 @cindex Startup files 163 @cindex Startup files
160 @cindex Default stylesheet 164 @cindex Default stylesheet
165
161 :: WORK :: startup files 166 :: WORK :: startup files
162 This section should document where emacs-w3 looks for its startup files, 167 This section should document where emacs-w3 looks for its startup files,
163 and what each one does. 'profile' 'stylesheet' 'hotlist' 'history' etc. 168 and what each one does. 'profile' 'stylesheet' 'hotlist' 'history' etc.
164 169
165 @node Preferences Panel, , Startup Files, Getting Started 170 @node Preferences Panel, , Startup Files, Getting Started
166 @section Preferences Panel 171 @section Preferences Panel
167 @cindex Preferences 172 @cindex Preferences
168 @kindex M-x w3-preferences-edit 173 @kindex M-x w3-preferences-edit
174
169 :: WORK :: pref panel 175 :: WORK :: pref panel
170 This should document the quick preferences panel. M-x w3-preferences-edit 176 This should document the quick preferences panel. M-x w3-preferences-edit
171 177
172 @node Basic Usage, Movement , Getting Started, Top 178 @node Basic Usage, Compatibility, Getting Started, Top
173 @chapter Basic Usage 179 @chapter Basic Usage
174 @cindex Basic Usage 180 @cindex Basic Usage
175 @kindex space 181 @kindex space
176 @kindex backspace 182 @kindex backspace
177 @kindex return 183 @kindex return
203 hypertext link @b{under the cursor}. 209 hypertext link @b{under the cursor}.
204 210
205 There are several areas that the keybindings fall into: movement, 211 There are several areas that the keybindings fall into: movement,
206 information, action, and miscellaneous. 212 information, action, and miscellaneous.
207 213
208 @ifinfo
209 @menu 214 @menu
210 * Movement:: Moving around in the buffer. 215 * Movement:: Moving around in the buffer.
211 * Information:: Getting information about a document. 216 * Information:: Getting information about a document.
212 * Action:: Following links, printing, etc. 217 * Action:: Following links, printing, etc.
213 * Miscellaneous:: Everything else. 218 * Miscellaneous:: Everything else.
214 @end menu 219 @end menu
215 @end ifinfo 220
216 @node Movement, Information, Basic Usage, Basic Usage 221 @node Movement, Information, Basic Usage, Basic Usage
217 @section Movement 222 @section Movement
223
218 All the standard Emacs bindings for movement are still in effect, with a 224 All the standard Emacs bindings for movement are still in effect, with a
219 few additions for convenience. 225 few additions for convenience.
220 226
221 @table @kbd 227 @table @kbd
222 @findex w3-scroll-up 228 @findex w3-scroll-up
271 Bury this buffer, but don't kill it 277 Bury this buffer, but don't kill it
272 @end table 278 @end table
273 279
274 @node Information, Action, Movement, Basic Usage 280 @node Information, Action, Movement, Basic Usage
275 @section Information 281 @section Information
282
276 These functions relate information about one or more links on the 283 These functions relate information about one or more links on the
277 current document. 284 current document.
278 285
279 @table @kbd 286 @table @kbd
280 @kindex v 287 @kindex v
319 the current window-system's clipboard, if possible. 326 the current window-system's clipboard, if possible.
320 @end table 327 @end table
321 328
322 @node Action, Miscellaneous, Information, Basic Usage 329 @node Action, Miscellaneous, Information, Basic Usage
323 @section Action 330 @section Action
331
324 First, here are the keys and functions that bring up a new hypertext 332 First, here are the keys and functions that bring up a new hypertext
325 page, usually creating a new buffer. 333 page, usually creating a new buffer.
326 @table @kbd 334 @table @kbd
327 @kindex m 335 @kindex m
328 @findex w3-complete-link 336 @findex w3-complete-link
458 @item HF, F 466 @item HF, F
459 Takes one step forward along the path in the current history. Has no 467 Takes one step forward along the path in the current history. Has no
460 effect if at the end of the session history. 468 effect if at the end of the session history.
461 @end table 469 @end table
462 470
463 @node Miscellaneous, Compatibility, Action, Basic Usage 471 @node Miscellaneous, , Action, Basic Usage
464 @section Miscellaneous 472 @section Miscellaneous
473
465 @table @kbd 474 @table @kbd
466 @kindex M-m 475 @kindex M-m
467 @findex w3-mail-current-document 476 @findex w3-mail-current-document
468 @item M-m 477 @item M-m
469 Mails the current document to someone. Choose from several different 478 Mails the current document to someone. Choose from several different
561 first asks what type of link to follow (Normal or Reverse), then does 570 first asks what type of link to follow (Normal or Reverse), then does
562 a @code{completing-read} on only the links that have that type of 571 a @code{completing-read} on only the links that have that type of
563 relationship. 572 relationship.
564 @end table 573 @end table
565 574
566 @node Compatibility, Emulation, Miscellaneous, Top 575 @node Compatibility, Stylesheets, Basic Usage, Top
567 @chapter Compatibility with other Browsers 576 @chapter Compatibility with other Browsers
568 Due to the popularity of several other browsers, Emacs-W3 offers an easy 577 Due to the popularity of several other browsers, Emacs-W3 offers an easy
569 transition to its much better way of life. This ranges from being able 578 transition to its much better way of life. This ranges from being able
570 to share the same preferences files and disk cache to actually emulating 579 to share the same preferences files and disk cache to actually emulating
571 the keybindings used in other browsers. 580 the keybindings used in other browsers.
572 581
573 @ifinfo
574 @menu 582 @menu
575 * Emulation:: Emacs-W3 can emulate the keybindings and 583 * Emulation:: Emacs-W3 can emulate the keybindings and
576 other behaviours of other browsers. 584 other behaviours of other browsers.
577 * Hotlist Handling:: A hotlist is an easy way to keep track of 585 * Hotlist Handling:: A hotlist is an easy way to keep track of
578 interesting Web pages without having to 586 interesting Web pages without having to
579 remember the exact path to get there. 587 remember the exact path to get there.
580 * Session History:: Keeping a history of documents visited 588 * Session History:: Keeping a history of documents visited
581 in one Emacs sessions allows the use of 589 in one Emacs sessions allows the use of
582 'forward' and 'back' buttons easily. 590 'forward' and 'back' buttons easily.
583 * Global History:: Keeping a history of all the places ever 591 * Global History:: Keeping a history of all the places ever
584 visited on the web. 592 visited on the web.
585 @end menu 593 @end menu
586 @end ifinfo 594
587 @node Emulation, Hotlist Handling, Compatibility, Compatibility 595 @node Emulation, Hotlist Handling, Compatibility, Compatibility
588 @section Emulation 596 @section Emulation
589 @cindex Browser emulation 597 @cindex Browser emulation
590 @cindex Emulation of other browsers 598 @cindex Emulation of other browsers
591 @cindex Netscape emulation 599 @cindex Netscape emulation
593 @findex turn-on-netscape-emulation 601 @findex turn-on-netscape-emulation
594 @findex turn-on-lynx-emulation 602 @findex turn-on-lynx-emulation
595 @findex w3-netscape-emulation-minor-mode 603 @findex w3-netscape-emulation-minor-mode
596 @findex w3-lynx-emulation-minor-mode 604 @findex w3-lynx-emulation-minor-mode
597 @vindex w3-mode-hook 605 @vindex w3-mode-hook
606
598 :: WORK :: Document lynx emulation 607 :: WORK :: Document lynx emulation
599 @table @bullet 608 @table @bullet
600 @item Down arrow 609 @item Down arrow
601 Highlight next topic 610 Highlight next topic
602 @item Up arrow 611 @item Up arrow
722 731
723 @end example 732 @end example
724 733
725 @node Hotlist Handling, Session History, Emulation, Compatibility 734 @node Hotlist Handling, Session History, Emulation, Compatibility
726 @section Hotlist Handling 735 @section Hotlist Handling
736
727 :: WORK :: Document that it supports different types of hotlist formats 737 :: WORK :: Document that it supports different types of hotlist formats
728 :: WORK :: Make sure everything hotlist related can be accessed via 'h' 738 :: WORK :: Make sure everything hotlist related can be accessed via 'h'
729 In order to avoid having to traverse many documents to get to the same 739 In order to avoid having to traverse many documents to get to the same
730 document over and over, Emacs-W3 supports a ``hotlist'' like Mosaic. This is 740 document over and over, Emacs-W3 supports a ``hotlist'' like Mosaic. This is
731 a file that contains @sc{url}s and aliases. Hotlists allow quick access to any 741 a file that contains @sc{url}s and aliases. Hotlists allow quick access to any
790 Appends another hotlist file to the one currently in memory. 800 Appends another hotlist file to the one currently in memory.
791 @end table 801 @end table
792 @node Session History, Global History, Hotlist Handling, Compatibility 802 @node Session History, Global History, Hotlist Handling, Compatibility
793 @section History 803 @section History
794 @cindex History Lists 804 @cindex History Lists
805
795 Almost all web browsers keep track of the @sc{url}s followed from a page, so 806 Almost all web browsers keep track of the @sc{url}s followed from a page, so
796 that it can provide @b{forward} and @b{back} buttons to keep a @i{path} 807 that it can provide @b{forward} and @b{back} buttons to keep a @i{path}
797 of @sc{url}s that can be traversed easily. 808 of @sc{url}s that can be traversed easily.
809
798 @vindex url-keep-history 810 @vindex url-keep-history
799 If the variable @code{url-keep-history} is @code{t}, then Emacs-W3 811 If the variable @code{url-keep-history} is @code{t}, then Emacs-W3
800 keeps a list of all the @sc{url}s visited in a session. 812 keeps a list of all the @sc{url}s visited in a session.
813
801 @findex w3-show-history 814 @findex w3-show-history
802 To view a listing of the history for this session of Emacs-W3, use 815 To view a listing of the history for this session of Emacs-W3, use
803 @code{M-x w3-show-history} from any buffer, and Emacs-W3 generates an 816 @code{M-x w3-show-history} from any buffer, and Emacs-W3 generates an
804 @sc{html} document showing every @sc{url} visited since Emacs started (or 817 @sc{html} document showing every @sc{url} visited since Emacs started (or
805 cleared the history list), and then format it. Any of the links can 818 cleared the history list), and then format it. Any of the links can
815 from that buffer. This means that the user can go forwards and 828 from that buffer. This means that the user can go forwards and
816 backwards very easily along the path taken to reach a particular 829 backwards very easily along the path taken to reach a particular
817 document. To go forward, use the function @code{w3-forward-in-history}, 830 document. To go forward, use the function @code{w3-forward-in-history},
818 to go backward, use the function @code{w3-backward-in-history}. 831 to go backward, use the function @code{w3-backward-in-history}.
819 832
820 @node Global History, Stylesheets, Session History, Compatibility 833 @node Global History, , Session History, Compatibility
821 @section Global History 834 @section Global History
835
822 :: WORK :: Document that the global history can have diff. formats 836 :: WORK :: Document that the global history can have diff. formats
823 Most web browsers also support the idea of a ``history'' of @sc{url}s the 837 Most web browsers also support the idea of a ``history'' of @sc{url}s the
824 user has visited, and it displays them in a different style than normal 838 user has visited, and it displays them in a different style than normal
825 @sc{url}s. 839 @sc{url}s.
826 840
846 the @kbd{tab} or @kbd{space} key will show all completions for a 860 the @kbd{tab} or @kbd{space} key will show all completions for a
847 partial @sc{url}. This is very useful, especially for very long @sc{url}s that 861 partial @sc{url}. This is very useful, especially for very long @sc{url}s that
848 are not in a hotlist, or for seeing all the pages from a particular web 862 are not in a hotlist, or for seeing all the pages from a particular web
849 site before choosing which to retrieve. 863 site before choosing which to retrieve.
850 864
851 @node Stylesheets, Terminology, Global History, Top 865 @node Stylesheets, Supported URLs, Compatibility, Top
852 @chapter Stylesheets 866 @chapter Stylesheets
853 The way in which Emacs-W3 formats a document is very customizable. All 867 The way in which Emacs-W3 formats a document is very customizable. All
854 formatting is now controlled by a default stylesheet set by the user 868 formatting is now controlled by a default stylesheet set by the user
855 with the @code{w3-default-stylesheet} variable. Emacs-W3 currently 869 with the @code{w3-default-stylesheet} variable. Emacs-W3 currently
856 supports the @sc{W3C} recommendation for Cascading Style Sheets, Level 1 870 supports the @sc{W3C} recommendation for Cascading Style Sheets, Level 1
866 it should be very easy to look up what Emacs-W3 supports when browsing 880 it should be very easy to look up what Emacs-W3 supports when browsing
867 through the @sc{CSS1} specification. Please note that a lot of the text 881 through the @sc{CSS1} specification. Please note that a lot of the text
868 in the following sections comes directly from the specification as 882 in the following sections comes directly from the specification as
869 well. 883 well.
870 884
871 @ifinfo
872 @menu 885 @menu
873 * Terminology:: Terms used in the rest of this chapter. 886 * Terminology:: Terms used in the rest of this chapter.
874 * Basic Concepts:: Why are stylesheets useful? Getting started. 887 * Basic Concepts:: Why are stylesheets useful? Getting started.
875 * Pseudo-Classes/Elements:: Special classes for elements. 888 * Pseudo-Classes/Elements:: Special classes for elements.
876 * The Cascade:: How stylesheets are combined. 889 * The Cascade:: How stylesheets are combined.
877 * Properties:: What properties you can set on elements. 890 * Properties:: What properties you can set on elements.
878 * Units:: What you can set them to. 891 * Units:: What you can set them to.
879 @end menu 892 @end menu
880 @end ifinfo
881 893
882 @node Terminology, Basic Concepts, Stylesheets, Stylesheets 894 @node Terminology, Basic Concepts, Stylesheets, Stylesheets
883 @section Terminology 895 @section Terminology
884 896
885 @table @dfn 897 @table @dfn
976 The priority of a rule. 988 The priority of a rule.
977 @end table 989 @end table
978 990
979 @node Basic Concepts, Pseudo-Classes/Elements, Terminology, Stylesheets 991 @node Basic Concepts, Pseudo-Classes/Elements, Terminology, Stylesheets
980 @section Basic Concepts 992 @section Basic Concepts
993
981 Designing simple style sheets is easy. One needs only to know a little 994 Designing simple style sheets is easy. One needs only to know a little
982 HTML and some basic desktop publishing terminology. E.g., to set the 995 HTML and some basic desktop publishing terminology. E.g., to set the
983 text color of 'H1' elements to blue, one can say: 996 text color of 'H1' elements to blue, one can say:
984 997
985 @example 998 @example
998 The selector is the link between the HTML document and the style sheet, and 1011 The selector is the link between the HTML document and the style sheet, and
999 all HTML element types are possible selectors. 1012 all HTML element types are possible selectors.
1000 1013
1001 @node Pseudo-Classes/Elements, The Cascade, Basic Concepts, Stylesheets 1014 @node Pseudo-Classes/Elements, The Cascade, Basic Concepts, Stylesheets
1002 @section Pseudo-Classes/Elements 1015 @section Pseudo-Classes/Elements
1016
1003 In @sc{css1}, style is normally attached to an element based on its 1017 In @sc{css1}, style is normally attached to an element based on its
1004 position in the document structure. This simple model is sufficient for 1018 position in the document structure. This simple model is sufficient for
1005 a wide variety of styles, but doesn't cover some common effects. The 1019 a wide variety of styles, but doesn't cover some common effects. The
1006 concept of pseudo-classes and pseudo-elements extend addressing in 1020 concept of pseudo-classes and pseudo-elements extend addressing in
1007 @sc{css1} to allow external information to influence the formatting 1021 @sc{css1} to allow external information to influence the formatting
1206 assumed to be at the start of the author style sheet and may be 1220 assumed to be at the start of the author style sheet and may be
1207 overridden by subsequent style sheet rules. In a transition phase, this 1221 overridden by subsequent style sheet rules. In a transition phase, this
1208 policy will make it easier for stylistic attributes to coexist with 1222 policy will make it easier for stylistic attributes to coexist with
1209 style sheets. 1223 style sheets.
1210 1224
1211 @node Properties, Font Properties, The Cascade, Stylesheets 1225 @node Properties, Units, The Cascade, Stylesheets
1212 @section Properties 1226 @section Properties
1213 1227
1214 In the text below, the allowed values for each property are listed 1228 In the text below, the allowed values for each property are listed
1215 with a syntax like the following: 1229 with a syntax like the following:
1216 1230
1267 @item Applies to: @tab What type of elements this property can be attached to. 1281 @item Applies to: @tab What type of elements this property can be attached to.
1268 @item Inherited: @tab Yes or no 1282 @item Inherited: @tab Yes or no
1269 @item Percentage values: @tab What a percentage value applies to when given. 1283 @item Percentage values: @tab What a percentage value applies to when given.
1270 @end multitable 1284 @end multitable
1271 1285
1272 @ifinfo
1273 @menu 1286 @menu
1274 * Font Properties:: Selecting fonts, styles, and sizes. 1287 * Font Properties:: Selecting fonts, styles, and sizes.
1275 * Colors and Backgrounds:: Controlling colors, front and back. 1288 * Colors and Backgrounds:: Controlling colors, front and back.
1276 * Text Properties:: Alignment, decoration, and more! 1289 * Text Properties:: Alignment, decoration, and more!
1277 * Box Properties:: Borders, padding, and margins, oh my! 1290 * Box Properties:: Borders, padding, and margins, oh my!
1278 * Classification:: Changing whitespace and display policies. 1291 * Classification:: Changing whitespace and display policies.
1279 * Media Selection:: Conditionalize stylesheets on media-type. 1292 * Media Selection:: Conditionalize stylesheets on media-type.
1280 * Speech Properties:: Speech output controlled by stylesheets. 1293 * Speech Properties:: Speech output controlled by stylesheets.
1281 @end menu 1294 @end menu
1282 @end ifinfo 1295
1283 1296 @node Font Properties, Colors and Backgrounds, Properties, Properties
1284 @node Font Properties, font-family, Properties, Properties
1285 @subsection Font Properties 1297 @subsection Font Properties
1298
1286 Setting font properties will be among the most common uses of style 1299 Setting font properties will be among the most common uses of style
1287 sheets. Unfortunately, there exists no well-defined and universally 1300 sheets. Unfortunately, there exists no well-defined and universally
1288 accepted taxonomy for classifying fonts, and terms that apply to one 1301 accepted taxonomy for classifying fonts, and terms that apply to one
1289 font family may not be appropriate for others. E.g. 'italic' is commonly 1302 font family may not be appropriate for others. E.g. 'italic' is commonly
1290 used to label slanted text, but slanted text may also be labeled as 1303 used to label slanted text, but slanted text may also be labeled as
1291 being @b{Oblique}, @b{Slanted}, @b{Incline}, @b{Cursive} or 1304 being @b{Oblique}, @b{Slanted}, @b{Incline}, @b{Cursive} or
1292 @b{Kursiv}. Therefore it is not a simple problem to map typical font 1305 @b{Kursiv}. Therefore it is not a simple problem to map typical font
1293 selection properties to a specific font. 1306 selection properties to a specific font.
1294 1307
1295 The properties defined by CSS1 are described in the following sections. 1308 The properties defined by CSS1 are described in the following sections.
1296 @ifinfo
1297 @menu 1309 @menu
1298 * font-family:: Groups of fonts. 1310 * font-family:: Groups of fonts.
1299 * font-style:: Normal, italic, or oblique? 1311 * font-style:: Normal, italic, or oblique?
1300 * font-variant:: Small-caps, etc. 1312 * font-variant:: Small-caps, etc.
1301 * font-weight:: How bold can you go? 1313 * font-weight:: How bold can you go?
1302 * font-size:: How big is yours? 1314 * font-size:: How big is yours?
1303 * font:: Shorthand for all of the above. 1315 * font:: Shorthand for all of the above.
1304 @end menu 1316 @end menu
1305 @end ifinfo
1306 1317
1307 @node font-family, font-style, Font Properties, Font Properties 1318 @node font-family, font-style, Font Properties, Font Properties
1308 @subsubsection font-family 1319 @subsubsection font-family
1309 1320
1310 @multitable @columnfractions .20 .8 1321 @multitable @columnfractions .20 .8
1541 @end example 1552 @end example
1542 1553
1543 If the suggested scaling factor of 1.5 is used, the last three 1554 If the suggested scaling factor of 1.5 is used, the last three
1544 declarations are identical. 1555 declarations are identical.
1545 1556
1546 @node font, Colors and Backgrounds, font-size, Font Properties 1557 @node font, , font-size, Font Properties
1547 @subsubsection font 1558 @subsubsection font
1548 1559
1549 @multitable @columnfractions .2 .8 1560 @multitable @columnfractions .2 .8
1550 @item Value: @tab [ <font-style> || <font-variant> || <font-weight> ]? <font-size> [ / <line-height> ]? <font-family> 1561 @item Value: @tab [ <font-style> || <font-variant> || <font-weight> ]? <font-size> [ / <line-height> ]? <font-family>
1551 @item Initial: @tab not defined for shorthand properties 1562 @item Initial: @tab not defined for shorthand properties
1585 (120% of the parent's font), the 'line-height' (120% times the font 1596 (120% of the parent's font), the 'line-height' (120% times the font
1586 size) and the 'font-family' ('fantasy'). It follows that the keyword 1597 size) and the 'font-family' ('fantasy'). It follows that the keyword
1587 'normal' applies to the two remaining properties: 'font-style' and 1598 'normal' applies to the two remaining properties: 'font-style' and
1588 'font-weight'. 1599 'font-weight'.
1589 1600
1590 @node Colors and Backgrounds, color, font, Properties 1601 @node Colors and Backgrounds, Text Properties, Font Properties, Properties
1591 @subsection Colors and Backgrounds 1602 @subsection Colors and Backgrounds
1603
1592 These properties describe the color (often called foreground color) and 1604 These properties describe the color (often called foreground color) and
1593 background of an element (i.e. the surface onto which the content is 1605 background of an element (i.e. the surface onto which the content is
1594 rendered). One can set a background color and/or a background image. The 1606 rendered). One can set a background color and/or a background image. The
1595 position of the image, if/how it is repeated, and whether it is fixed or 1607 position of the image, if/how it is repeated, and whether it is fixed or
1596 scrolled relative to the canvas can also be set. 1608 scrolled relative to the canvas can also be set.
1601 'background-color'. 1613 'background-color'.
1602 1614
1603 NOTE: Currently, Emacs-W3 can only show background images under XEmacs. 1615 NOTE: Currently, Emacs-W3 can only show background images under XEmacs.
1604 Emacs 19 doesn't have the support in its display code yet. 1616 Emacs 19 doesn't have the support in its display code yet.
1605 1617
1606 @ifinfo
1607 @menu 1618 @menu
1608 * color:: Foreground colors. 1619 * color:: Foreground colors.
1609 * background-color:: Background colors. 1620 * background-color:: Background colors.
1610 * background-image:: Background images. 1621 * background-image:: Background images.
1611 * background-repeat:: Controlling repeating of background images. 1622 * background-repeat:: Controlling repeating of background images.
1612 * background-attachment:: Where background images are drawn. 1623 * background-attachment:: Where background images are drawn.
1613 * background-position:: Where background images are drawn. 1624 * background-position:: Where background images are drawn.
1614 * background:: Shorthand for all background properties. 1625 * background:: Shorthand for all background properties.
1615 @end menu 1626 @end menu
1616 @end ifinfo
1617 1627
1618 @node color, background-color, Colors and Backgrounds, Colors and Backgrounds 1628 @node color, background-color, Colors and Backgrounds, Colors and Backgrounds
1619 @subsubsection color 1629 @subsubsection color
1630
1620 @multitable @columnfractions .2 .8 1631 @multitable @columnfractions .2 .8
1621 @item Value: @tab <color> 1632 @item Value: @tab <color>
1622 @item Initial: @tab User specific 1633 @item Initial: @tab User specific
1623 @item Applies to: @tab all elements 1634 @item Applies to: @tab all elements
1624 @item Inherited: @tab yes 1635 @item Inherited: @tab yes
1635 1646
1636 See @ref{Color Units} for a description of possible color values. 1647 See @ref{Color Units} for a description of possible color values.
1637 1648
1638 @node background-color, background-image, color, Colors and Backgrounds 1649 @node background-color, background-image, color, Colors and Backgrounds
1639 @subsubsection background-color 1650 @subsubsection background-color
1651
1640 @multitable @columnfractions .2 .8 1652 @multitable @columnfractions .2 .8
1641 @item Value: @tab <color> | transparent 1653 @item Value: @tab <color> | transparent
1642 @item Initial: @tab transparent 1654 @item Initial: @tab transparent
1643 @item Applies to: @tab all elements 1655 @item Applies to: @tab all elements
1644 @item Inherited: @tab no 1656 @item Inherited: @tab no
1651 H1 @{ background-color: #F00 @} 1663 H1 @{ background-color: #F00 @}
1652 @end example 1664 @end example
1653 1665
1654 @node background-image, background-repeat, background-color, Colors and Backgrounds 1666 @node background-image, background-repeat, background-color, Colors and Backgrounds
1655 @subsubsection background-image 1667 @subsubsection background-image
1668
1656 @multitable @columnfractions .2 .8 1669 @multitable @columnfractions .2 .8
1657 @item Value: @tab <url> | none 1670 @item Value: @tab <url> | none
1658 @item Initial: @tab none 1671 @item Initial: @tab none
1659 @item Applies to: @tab all elements 1672 @item Applies to: @tab all elements
1660 @item Inherited: @tab no 1673 @item Inherited: @tab no
1671 P @{ background-image: none @} 1684 P @{ background-image: none @}
1672 @end example 1685 @end example
1673 1686
1674 @node background-repeat, background-attachment, background-image, Colors and Backgrounds 1687 @node background-repeat, background-attachment, background-image, Colors and Backgrounds
1675 @subsubsection background-repeat 1688 @subsubsection background-repeat
1689
1676 This property is not supported at all under Emacs-W3. 1690 This property is not supported at all under Emacs-W3.
1677 1691
1678 @node background-attachment, background-position, background-repeat, Colors and Backgrounds 1692 @node background-attachment, background-position, background-repeat, Colors and Backgrounds
1679 @subsubsection background-attachment 1693 @subsubsection background-attachment
1694
1680 This property is not supported at all under Emacs-W3. 1695 This property is not supported at all under Emacs-W3.
1681 1696
1682 @node background-position, background, background-attachment, Colors and Backgrounds 1697 @node background-position, background, background-attachment, Colors and Backgrounds
1683 @subsubsection background-position 1698 @subsubsection background-position
1699
1684 This property is not supported at all under Emacs-W3. 1700 This property is not supported at all under Emacs-W3.
1685 1701
1686 @node background, Text Properties, background-position, Colors and Backgrounds 1702 @node background, , background-position, Colors and Backgrounds
1687 @subsubsection background 1703 @subsubsection background
1704
1688 @multitable @columnfractions .2 .8 1705 @multitable @columnfractions .2 .8
1689 @item Value: @tab <background-color> || <background-image> || <background-repeat> || <background-attachment> || <background-position> 1706 @item Value: @tab <background-color> || <background-image> || <background-repeat> || <background-attachment> || <background-position>
1690 @item Initial: @tab not defined for shorthand properties 1707 @item Initial: @tab not defined for shorthand properties
1691 @item Applies to: @tab all elements 1708 @item Applies to: @tab all elements
1692 @item Inherited: @tab no 1709 @item Inherited: @tab no
1710 properties. In the first rule of the above example, only a value for 1727 properties. In the first rule of the above example, only a value for
1711 'background-color' has been given and the other individual properties 1728 'background-color' has been given and the other individual properties
1712 are set to their initial value. In the second rule, all individual 1729 are set to their initial value. In the second rule, all individual
1713 properties have been specified. 1730 properties have been specified.
1714 1731
1715 @node Text Properties, word-spacing, background, Properties 1732 @node Text Properties, Box Properties, Colors and Backgrounds, Properties
1716 @subsection Text Properties 1733 @subsection Text Properties
1717 1734
1718 @ifinfo
1719 @menu 1735 @menu
1720 * word-spacing:: 1736 * word-spacing::
1721 * letter-spacing:: 1737 * letter-spacing::
1722 * text-decoration:: 1738 * text-decoration::
1723 * vertical-align:: 1739 * vertical-align::
1724 * text-transform:: 1740 * text-transform::
1725 * text-align:: 1741 * text-align::
1726 * text-indent:: 1742 * text-indent::
1727 * line-height:: 1743 * line-height::
1728 @end menu 1744 @end menu
1729 @end ifinfo
1730 1745
1731 @node word-spacing, letter-spacing, Text Properties, Text Properties 1746 @node word-spacing, letter-spacing, Text Properties, Text Properties
1732 @subsubsection word-spacing 1747 @subsubsection word-spacing
1748
1733 @multitable @columnfractions .2 .8 1749 @multitable @columnfractions .2 .8
1734 @item Supported Values: @tab normal 1750 @item Supported Values: @tab normal
1735 @item Unsupported Values: @tab <length> 1751 @item Unsupported Values: @tab <length>
1736 @item Initial: @tab normal 1752 @item Initial: @tab normal
1737 @item Applies to: @tab all elements 1753 @item Applies to: @tab all elements
1755 NOTE: Emacs-W3 cannot currently support this, due to limitations in 1771 NOTE: Emacs-W3 cannot currently support this, due to limitations in
1756 Emacs. It may be implemented in the future. 1772 Emacs. It may be implemented in the future.
1757 1773
1758 @node letter-spacing, text-decoration, word-spacing, Text Properties 1774 @node letter-spacing, text-decoration, word-spacing, Text Properties
1759 @subsubsection letter-spacing 1775 @subsubsection letter-spacing
1760 @multitable @columnfractions .2 .8 1776
1761 @item Supported Values: normal 1777 @multitable @columnfractions .2 .8
1778 @item Supported Values: @tab normal
1762 @item Unsupported Values: @tab <length> 1779 @item Unsupported Values: @tab <length>
1763 @item Initial: @tab normal 1780 @item Initial: @tab normal
1764 @item Applies to: @tab all elements 1781 @item Applies to: @tab all elements
1765 @item Inherited: @tab yes 1782 @item Inherited: @tab yes
1766 @item Percentage values: @tab N/A 1783 @item Percentage values: @tab N/A
1780 would be increased by '0.1em'. 1797 would be increased by '0.1em'.
1781 1798
1782 NOTE: Emacs-W3 cannot currently support this, due to limitations in 1799 NOTE: Emacs-W3 cannot currently support this, due to limitations in
1783 Emacs. It may be implemented in the future. 1800 Emacs. It may be implemented in the future.
1784 1801
1785 @node text-decoration, vertical-align, letter-spacing , Text Properties 1802 @node text-decoration, vertical-align, letter-spacing, Text Properties
1786 @subsubsection text-decoration 1803 @subsubsection text-decoration
1804
1787 @multitable @columnfractions .2 .8 1805 @multitable @columnfractions .2 .8
1788 @item Supported Values: @tab none | underline | line-through | blink 1806 @item Supported Values: @tab none | underline | line-through | blink
1789 @item Unsupported Values: @tab overline 1807 @item Unsupported Values: @tab overline
1790 @item Initial: @tab none 1808 @item Initial: @tab none
1791 @item Applies to: @tab all elements 1809 @item Applies to: @tab all elements
1818 support for this, but it has not made it into the main distribution 1836 support for this, but it has not made it into the main distribution
1819 yet. 1837 yet.
1820 1838
1821 @node vertical-align, text-transform, text-decoration, Text Properties 1839 @node vertical-align, text-transform, text-decoration, Text Properties
1822 @subsubsection vertical-align 1840 @subsubsection vertical-align
1841
1823 This is currently unsupported in Emacs-W3. 1842 This is currently unsupported in Emacs-W3.
1824 1843
1825 @node text-transform, text-align, vertical-align, Text Properties 1844 @node text-transform, text-align, vertical-align, Text Properties
1826 @subsubsection text-transform 1845 @subsubsection text-transform
1846
1827 @multitable @columnfractions .2 .8 1847 @multitable @columnfractions .2 .8
1828 @item Supported Values: @tab none 1848 @item Supported Values: @tab none
1829 @item Unsupported Values: @tab capitalize | uppercase | lowercase 1849 @item Unsupported Values: @tab capitalize | uppercase | lowercase
1830 @item Initial: @tab none 1850 @item Initial: @tab none
1831 @item Applies to: @tab all elements 1851 @item Applies to: @tab all elements
1856 not been reimplemented in the new display code yet. Please feel free to 1876 not been reimplemented in the new display code yet. Please feel free to
1857 send me patches. 1877 send me patches.
1858 1878
1859 @node text-align, text-indent, text-transform, Text Properties 1879 @node text-align, text-indent, text-transform, Text Properties
1860 @subsubsection text-align 1880 @subsubsection text-align
1881
1861 @multitable @columnfractions .2 .8 1882 @multitable @columnfractions .2 .8
1862 @item Value: @tab left | right | center | justify 1883 @item Value: @tab left | right | center | justify
1863 @item Initial: @tab User specific 1884 @item Initial: @tab User specific
1864 @item Applies to: @tab block-level elements 1885 @item Applies to: @tab block-level elements
1865 @item Inherited: @tab yes 1886 @item Inherited: @tab yes
1878 element with 'CLASS=center' will be centered. Note that alignments are 1899 element with 'CLASS=center' will be centered. Note that alignments are
1879 relative to the width of the element, not the canvas. 1900 relative to the width of the element, not the canvas.
1880 1901
1881 @node text-indent, line-height, text-align, Text Properties 1902 @node text-indent, line-height, text-align, Text Properties
1882 @subsubsection text-indent 1903 @subsubsection text-indent
1904
1883 Not currently implemented in Emacs-W3. 1905 Not currently implemented in Emacs-W3.
1884 1906
1885 @node line-height, Box Properties, text-indent, Text Properties 1907 @node line-height, , text-indent, Text Properties
1886 @subsubsection line-height 1908 @subsubsection line-height
1909
1887 Not currently implemented in Emacs-W3. 1910 Not currently implemented in Emacs-W3.
1888 1911
1889 @node Box Properties, Classification, line-height, Properties 1912 @node Box Properties, Classification, Text Properties, Properties
1890 @subsection Box Properties 1913 @subsection Box Properties
1891 @multitable @columnfractions .2 .8 1914
1892 @end multitable 1915 @multitable @columnfractions .2 .8
1893 1916 @end multitable
1894 @node Classification, display, Box Properties, Properties 1917
1918 @node Classification, Media Selection, Box Properties, Properties
1895 @subsection Classification 1919 @subsection Classification
1920
1896 These properties classify elements into categories more than they set 1921 These properties classify elements into categories more than they set
1897 specific visual parameters. 1922 specific visual parameters.
1898 1923
1899 The list-style properties describe how list items (i.e. elements with a 1924 The list-style properties describe how list items (i.e. elements with a
1900 'display' value of 'list-item') are formatted. The list-style properties 1925 'display' value of 'list-item') are formatted. The list-style properties
1901 can be set on any element, and it will inherit normally down the 1926 can be set on any element, and it will inherit normally down the
1902 tree. However, they will only be have effect on elements with a 1927 tree. However, they will only be have effect on elements with a
1903 'display' value of 'list-item'. In HTML this is typically the case for 1928 'display' value of 'list-item'. In HTML this is typically the case for
1904 the 'LI' element. 1929 the 'LI' element.
1905 1930
1906 @ifinfo
1907 @menu 1931 @menu
1908 * display:: 1932 * display::
1909 * white-space:: 1933 * white-space::
1910 * list-style-type:: 1934 * list-style-type::
1911 * list-style-image:: 1935 * list-style-image::
1912 * list-style-position:: 1936 * list-style-position::
1913 * list-style:: 1937 * list-style::
1914 @end menu 1938 @end menu
1915 @end ifinfo
1916 1939
1917 @node display, white-space, Classification, Classification 1940 @node display, white-space, Classification, Classification
1918 @subsubsection display 1941 @subsubsection display
1942
1919 @multitable @columnfractions .2 .8 1943 @multitable @columnfractions .2 .8
1920 @item Value: @tab block | inline | list-item | none 1944 @item Value: @tab block | inline | list-item | none
1921 @item Extensions: @tab line 1945 @item Extensions: @tab line
1922 @item Initial: @tab inline 1946 @item Initial: @tab inline
1923 @item Applies to: @tab all elements 1947 @item Applies to: @tab all elements
1955 NOTE: Emacs-W3 defaults to using 'inline' for this property, which is a 1979 NOTE: Emacs-W3 defaults to using 'inline' for this property, which is a
1956 slight deviation from the specification. 1980 slight deviation from the specification.
1957 1981
1958 @node white-space, list-style-type, display, Classification 1982 @node white-space, list-style-type, display, Classification
1959 @subsubsection white-space 1983 @subsubsection white-space
1984
1960 @multitable @columnfractions .2 .8 1985 @multitable @columnfractions .2 .8
1961 @item Value: @tab normal | pre | nowrap 1986 @item Value: @tab normal | pre | nowrap
1962 @item Initial: @tab normal 1987 @item Initial: @tab normal
1963 @item Applies to: @tab block-level elements 1988 @item Applies to: @tab block-level elements
1964 @item Inherited: @tab yes 1989 @item Inherited: @tab yes
1975 P @{ white-space: normal @} 2000 P @{ white-space: normal @}
1976 @end example 2001 @end example
1977 2002
1978 @node list-style-type, list-style-image, white-space, Classification 2003 @node list-style-type, list-style-image, white-space, Classification
1979 @subsubsection list-style-type 2004 @subsubsection list-style-type
2005
1980 @multitable @columnfractions .2 .8 2006 @multitable @columnfractions .2 .8
1981 @item Value: @tab disc | circle | square | decimal | lower-roman | upper-roman | lower-alpha | upper-alpha | none 2007 @item Value: @tab disc | circle | square | decimal | lower-roman | upper-roman | lower-alpha | upper-alpha | none
1982 @item Initial: @tab disc 2008 @item Initial: @tab disc
1983 @item Applies to: @tab elements with 'display' value 'list-item' 2009 @item Applies to: @tab elements with 'display' value 'list-item'
1984 @item Inherited: @tab yes 2010 @item Inherited: @tab yes
1996 OL @{ list-style-type: lower-roman @} /* i ii iii iv v etc. */ 2022 OL @{ list-style-type: lower-roman @} /* i ii iii iv v etc. */
1997 @end example 2023 @end example
1998 2024
1999 @node list-style-image, list-style-position, list-style-type, Classification 2025 @node list-style-image, list-style-position, list-style-type, Classification
2000 @subsubsection list-style-image 2026 @subsubsection list-style-image
2027
2001 @multitable @columnfractions .2 .8 2028 @multitable @columnfractions .2 .8
2002 @item Value: @tab <url> | none 2029 @item Value: @tab <url> | none
2003 @item Initial: @tab none 2030 @item Initial: @tab none
2004 @item Applies to: @tab elements with 'display' value 'list-item' 2031 @item Applies to: @tab elements with 'display' value 'list-item'
2005 @item Inherited: @tab yes 2032 @item Inherited: @tab yes
2016 UL @{ list-style-image: url(http://png.com/ellipse.png) @} 2043 UL @{ list-style-image: url(http://png.com/ellipse.png) @}
2017 @end example 2044 @end example
2018 2045
2019 @node list-style-position, list-style, list-style-image, Classification 2046 @node list-style-position, list-style, list-style-image, Classification
2020 @subsubsection list-style-position 2047 @subsubsection list-style-position
2048
2021 @multitable @columnfractions .2 .8 2049 @multitable @columnfractions .2 .8
2022 @item Supported Values: @tab outside 2050 @item Supported Values: @tab outside
2023 @item Unsupported Values: @tab inside 2051 @item Unsupported Values: @tab inside
2024 @item Initial: @tab outside 2052 @item Initial: @tab outside
2025 @item Applies to: @tab elements with 'display' value 'list-item' 2053 @item Applies to: @tab elements with 'display' value 'list-item'
2029 2057
2030 The value of 'list-style-position' determines how the list-item marker 2058 The value of 'list-style-position' determines how the list-item marker
2031 is drawn with regard to the content. For a formatting example see 2059 is drawn with regard to the content. For a formatting example see
2032 section 4.1.3. 2060 section 4.1.3.
2033 2061
2034 @node list-style, Media Selection, list-style-position, Classification 2062 @node list-style, , list-style-position, Classification
2035 @subsubsection list-style 2063 @subsubsection list-style
2036 @multitable @columnfractions .2 .8 2064
2037 @item Value: <keyword> || <position> || <url> 2065 @multitable @columnfractions .2 .8
2066 @item Value: @tab <keyword> || <position> || <url>
2038 @item Initial: @tab not defined for shorthand properties 2067 @item Initial: @tab not defined for shorthand properties
2039 @item Applies to: @tab elements with 'display' value 'list-item' 2068 @item Applies to: @tab elements with 'display' value 'list-item'
2040 @item Inherited: @tab yes 2069 @item Inherited: @tab yes
2041 @item Percentage values: @tab N/A 2070 @item Percentage values: @tab N/A
2042 @end multitable 2071 @end multitable
2090 @end example 2119 @end example
2091 2120
2092 In the example above, the 'disc' will be used when the image is 2121 In the example above, the 'disc' will be used when the image is
2093 unavailable. 2122 unavailable.
2094 2123
2095 @node Media Selection, Speech Properties, list-style, Properties 2124 @node Media Selection, Speech Properties, Classification, Properties
2096 @subsection Media Selection 2125 @subsection Media Selection
2126
2097 To specify that a stylesheet declaration should only apply when using a 2127 To specify that a stylesheet declaration should only apply when using a
2098 certain media type (ie: different font families preferred when printing 2128 certain media type (ie: different font families preferred when printing
2099 versus on-screen presentation), the declarations should be wrapped in 2129 versus on-screen presentation), the declarations should be wrapped in
2100 the proposed @b{@@media} directive. 2130 the proposed @b{@@media} directive.
2101 2131
2139 The stylesheet will only be applied if the user is running in XEmacs 19. 2169 The stylesheet will only be applied if the user is running in XEmacs 19.
2140 @item All 2170 @item All
2141 The default value, the style sheet applies to all output devices 2171 The default value, the style sheet applies to all output devices
2142 @end table 2172 @end table
2143 2173
2144 @node Speech Properties, volume, Media Selection, Properties 2174 @node Speech Properties, , Media Selection, Properties
2145 @subsection Speech Properties 2175 @subsection Speech Properties
2176
2146 Those of us who are sighted are accustomed to visual presentation of 2177 Those of us who are sighted are accustomed to visual presentation of
2147 @sc{html} documents, frequently on a bitmapped display. This is not the 2178 @sc{html} documents, frequently on a bitmapped display. This is not the
2148 only possible presentation method, however. Aural presentation, using a 2179 only possible presentation method, however. Aural presentation, using a
2149 combination of speech synthesis and 'audio icons', provides an 2180 combination of speech synthesis and 'audio icons', provides an
2150 alternative presentation. This form of presentation is in current use by 2181 alternative presentation. This form of presentation is in current use by
2168 @item 2199 @item
2169 Allows browsers to optionally implement both aural and visual views to 2200 Allows browsers to optionally implement both aural and visual views to
2170 produce truly multimodal documents. 2201 produce truly multimodal documents.
2171 @end itemize 2202 @end itemize
2172 2203
2173 @ifinfo
2174 @menu 2204 @menu
2175 * volume:: 2205 * volume::
2176 * pause-before:: 2206 * pause-before::
2177 * pause-after:: 2207 * pause-after::
2178 * pause:: 2208 * pause::
2179 * cue-before:: 2209 * cue-before::
2180 * cue-after:: 2210 * cue-after::
2181 * cue:: 2211 * cue::
2182 * play-during:: 2212 * play-during::
2183 * speed:: 2213 * speed::
2184 * voice-family:: 2214 * voice-family::
2185 * pitch:: 2215 * pitch::
2186 * pitch-range:: 2216 * pitch-range::
2187 * stress:: 2217 * stress::
2188 * richness:: 2218 * richness::
2189 * speak-punctuation:: 2219 * speak-punctuation::
2190 * speak-date:: 2220 * speak-date::
2191 * speak-numeral:: 2221 * speak-numeral::
2192 * speak-time:: 2222 * speak-time::
2193 @end menu 2223 @end menu
2194 @end ifinfo
2195 2224
2196 @node volume, pause-before, Speech Properties, Speech Properties 2225 @node volume, pause-before, Speech Properties, Speech Properties
2197 @subsubsection volume 2226 @subsubsection volume
2227
2198 @multitable @columnfractions .2 .8 2228 @multitable @columnfractions .2 .8
2199 @item Value: @tab <percentage> | mute | x-soft | soft | medium | loud | x-loud 2229 @item Value: @tab <percentage> | mute | x-soft | soft | medium | loud | x-loud
2200 @item Initial: @tab medium 2230 @item Initial: @tab medium
2201 @item Applies to: @tab all elements 2231 @item Applies to: @tab all elements
2202 @item Inherited: @tab yes 2232 @item Inherited: @tab yes
2249 The same authors stylesheet could be used in all cases, simply by 2279 The same authors stylesheet could be used in all cases, simply by
2250 mapping the 0 and 100 points suitably at the client side. 2280 mapping the 0 and 100 points suitably at the client side.
2251 2281
2252 @node pause-before, pause-after, volume, Speech Properties 2282 @node pause-before, pause-after, volume, Speech Properties
2253 @subsubsection pause-before 2283 @subsubsection pause-before
2284
2254 @multitable @columnfractions .2 .8 2285 @multitable @columnfractions .2 .8
2255 @item Value: @tab <time> | <percentage> 2286 @item Value: @tab <time> | <percentage>
2256 @item Initial: @tab UA specific 2287 @item Initial: @tab UA specific
2257 @item Applies to: @tab all elements 2288 @item Applies to: @tab all elements
2258 @item Inherited: @tab no 2289 @item Inherited: @tab no
2269 Using relative units gives more robust stylesheets in the face of large 2300 Using relative units gives more robust stylesheets in the face of large
2270 changes in speed. 2301 changes in speed.
2271 2302
2272 @node pause-after, pause, pause-before, Speech Properties 2303 @node pause-after, pause, pause-before, Speech Properties
2273 @subsubsection pause-after 2304 @subsubsection pause-after
2305
2274 @multitable @columnfractions .2 .8 2306 @multitable @columnfractions .2 .8
2275 @item Value: @tab <time> | <percentage> 2307 @item Value: @tab <time> | <percentage>
2276 @item Applies to: @tab all elements 2308 @item Applies to: @tab all elements
2277 @item Inherited: @tab no 2309 @item Inherited: @tab no
2278 @item Percentage values: @tab speed 2310 @item Percentage values: @tab speed
2281 This property specifies the pause after elements. Values are specified 2313 This property specifies the pause after elements. Values are specified
2282 the same way as 'pause-before'. 2314 the same way as 'pause-before'.
2283 2315
2284 @node pause, cue-before, pause-after, Speech Properties 2316 @node pause, cue-before, pause-after, Speech Properties
2285 @subsubsection pause 2317 @subsubsection pause
2318
2286 @multitable @columnfractions .2 .8 2319 @multitable @columnfractions .2 .8
2287 @item Value: @tab [<time> | <percentage> ]@{1,2@}; 2320 @item Value: @tab [<time> | <percentage> ]@{1,2@};
2288 @item Applies to: @tab all elements 2321 @item Applies to: @tab all elements
2289 @item Inherited: @tab no 2322 @item Inherited: @tab no
2290 @item Percentage values: @tab speed 2323 @item Percentage values: @tab speed
2302 H3 @{ pause-after: 10ms @} /* pause-before: ?; pause-after: 10ms */ 2335 H3 @{ pause-after: 10ms @} /* pause-before: ?; pause-after: 10ms */
2303 @end example 2336 @end example
2304 2337
2305 @node cue-before, cue-after, pause, Speech Properties 2338 @node cue-before, cue-after, pause, Speech Properties
2306 @subsubsection cue-before 2339 @subsubsection cue-before
2340
2307 @multitable @columnfractions .2 .8 2341 @multitable @columnfractions .2 .8
2308 @item Value: @tab <url> | none 2342 @item Value: @tab <url> | none
2309 @item Initial: @tab none 2343 @item Initial: @tab none
2310 @item Applies to: @tab all elements 2344 @item Applies to: @tab all elements
2311 @item Inherited: @tab no 2345 @item Inherited: @tab no
2322 H1 @{ cue: url(pop.au) @} /* same as previous */ 2356 H1 @{ cue: url(pop.au) @} /* same as previous */
2323 @end example 2357 @end example
2324 2358
2325 @node cue-after, cue, cue-before, Speech Properties 2359 @node cue-after, cue, cue-before, Speech Properties
2326 @subsubsection cue-after 2360 @subsubsection cue-after
2361
2327 @xref{cue-before} 2362 @xref{cue-before}
2328 2363
2329 @node cue, play-during, cue-after, Speech Properties 2364 @node cue, play-during, cue-after, Speech Properties
2330 @subsubsection cue 2365 @subsubsection cue
2366
2331 @xref{cue-before} 2367 @xref{cue-before}
2332 2368
2333 @node play-during, speed, cue, Speech Properties 2369 @node play-during, speed, cue, Speech Properties
2334 @subsubsection cue-during 2370 @subsubsection cue-during
2371
2335 @multitable @columnfractions .2 .8 2372 @multitable @columnfractions .2 .8
2336 @item Value: @tab <url> | mix | none 2373 @item Value: @tab <url> | mix | none
2337 @item Initial: @tab mix 2374 @item Initial: @tab mix
2338 @item Applies to: @tab all elements 2375 @item Applies to: @tab all elements
2339 @item Inherited: @tab no 2376 @item Inherited: @tab no
2348 BLOCKQUOTE.sad @{ cue-during: url(violins.aiff) @} 2385 BLOCKQUOTE.sad @{ cue-during: url(violins.aiff) @}
2349 @end example 2386 @end example
2350 2387
2351 @node speed, voice-family, play-during, Speech Properties 2388 @node speed, voice-family, play-during, Speech Properties
2352 @subsubsection speed 2389 @subsubsection speed
2390
2353 @multitable @columnfractions .2 .8 2391 @multitable @columnfractions .2 .8
2354 @item Value: @tab <words-per-minute> | x-slow | slow | medium | fast | x-fast | faster | slower 2392 @item Value: @tab <words-per-minute> | x-slow | slow | medium | fast | x-fast | faster | slower
2355 @item Initial: @tab medium 2393 @item Initial: @tab medium
2356 @item Applies to: @tab all elements 2394 @item Applies to: @tab all elements
2357 @item Inherited: @tab yes 2395 @item Inherited: @tab yes
2360 Specifies the speaking rate. Note that both absolute and relative 2398 Specifies the speaking rate. Note that both absolute and relative
2361 keyword values are allowed (compare with @ref{font-weight}). 2399 keyword values are allowed (compare with @ref{font-weight}).
2362 2400
2363 @node voice-family, pitch, speed, Speech Properties 2401 @node voice-family, pitch, speed, Speech Properties
2364 @subsubsection voice-family 2402 @subsubsection voice-family
2403
2365 @multitable @columnfractions .2 .8 2404 @multitable @columnfractions .2 .8
2366 @item Value: @tab [[<specific-voice> | <generic-voice>],]* [<specific-voice> | <generic-voice>] 2405 @item Value: @tab [[<specific-voice> | <generic-voice>],]* [<specific-voice> | <generic-voice>]
2367 @item Initial: @tab device-specific 2406 @item Initial: @tab device-specific
2368 @item Applies to: @tab all elements 2407 @item Applies to: @tab all elements
2369 @item Inherited: @tab yes 2408 @item Inherited: @tab yes
2382 P.part.juliet @{ voice-family: juliet, female @} 2421 P.part.juliet @{ voice-family: juliet, female @}
2383 @end example 2422 @end example
2384 2423
2385 @node pitch, pitch-range, voice-family, Speech Properties 2424 @node pitch, pitch-range, voice-family, Speech Properties
2386 @subsubsection pitch 2425 @subsubsection pitch
2426
2387 @multitable @columnfractions .2 .8 2427 @multitable @columnfractions .2 .8
2388 @end multitable 2428 @end multitable
2389 2429
2390 @node pitch-range, stress, pitch, Speech Properties 2430 @node pitch-range, stress, pitch, Speech Properties
2391 @subsubsection pitch-range 2431 @subsubsection pitch-range
2432
2392 @multitable @columnfractions .2 .8 2433 @multitable @columnfractions .2 .8
2393 @end multitable 2434 @end multitable
2394 2435
2395 @node stress, richness, pitch-range, Speech Properties 2436 @node stress, richness, pitch-range, Speech Properties
2396 @subsubsection stress 2437 @subsubsection stress
2438
2397 @multitable @columnfractions .2 .8 2439 @multitable @columnfractions .2 .8
2398 @item Value: @tab <percentage> 2440 @item Value: @tab <percentage>
2399 @item Initial: @tab medium 2441 @item Initial: @tab medium
2400 @item Applies to: @tab all elements 2442 @item Applies to: @tab all elements
2401 @item Inherited: @tab yes 2443 @item Inherited: @tab yes
2411 strongly inflected. It is in a sense dual to property 'pitch-range' and 2453 strongly inflected. It is in a sense dual to property 'pitch-range' and
2412 is provided to allow developers to exploit higher-end auditory displays. 2454 is provided to allow developers to exploit higher-end auditory displays.
2413 2455
2414 @node richness, speak-punctuation, stress, Speech Properties 2456 @node richness, speak-punctuation, stress, Speech Properties
2415 @subsubsection richness 2457 @subsubsection richness
2458
2416 @multitable @columnfractions .2 .8 2459 @multitable @columnfractions .2 .8
2417 @item Value: @tab <percentage> 2460 @item Value: @tab <percentage>
2418 @item Initial: @tab medium (50%) 2461 @item Initial: @tab medium (50%)
2419 @item Applies to: @tab all elements 2462 @item Applies to: @tab all elements
2420 @item Inherited: @tab yes 2463 @item Inherited: @tab yes
2427 The effect of increasing richness is to produce a voice that carries -- 2470 The effect of increasing richness is to produce a voice that carries --
2428 reducing richness produces a soft, mellifluous voice. 2471 reducing richness produces a soft, mellifluous voice.
2429 2472
2430 @node speak-punctuation, speak-date, richness, Speech Properties 2473 @node speak-punctuation, speak-date, richness, Speech Properties
2431 @subsubsection speak-punctuation 2474 @subsubsection speak-punctuation
2475
2432 @multitable @columnfractions .2 .8 2476 @multitable @columnfractions .2 .8
2433 @item Value: @tab code | none 2477 @item Value: @tab code | none
2434 @item Initial: @tab none 2478 @item Initial: @tab none
2435 @item Applies to: @tab all elements 2479 @item Applies to: @tab all elements
2436 @item Inherited: @tab yes 2480 @item Inherited: @tab yes
2441 punctuation is not spoken but instead is rendered naturally as various 2485 punctuation is not spoken but instead is rendered naturally as various
2442 pauses. 2486 pauses.
2443 2487
2444 @node speak-date, speak-numeral, speak-punctuation, Speech Properties 2488 @node speak-date, speak-numeral, speak-punctuation, Speech Properties
2445 @subsubsection speak-date 2489 @subsubsection speak-date
2490
2446 @multitable @columnfractions .2 .8 2491 @multitable @columnfractions .2 .8
2447 @item Value: @tab myd | dmy | ymd | none 2492 @item Value: @tab myd | dmy | ymd | none
2448 @item Initial: @tab none 2493 @item Initial: @tab none
2449 @item Applies to: @tab all elements 2494 @item Applies to: @tab all elements
2450 @item Inherited: @tab no 2495 @item Inherited: @tab no
2457 This should really be an HTML tag not a stylesheet property, since it 2502 This should really be an HTML tag not a stylesheet property, since it
2458 gives semantic information about the content. 2503 gives semantic information about the content.
2459 2504
2460 @node speak-numeral, speak-time, speak-date, Speech Properties 2505 @node speak-numeral, speak-time, speak-date, Speech Properties
2461 @subsubsection speak-numeral 2506 @subsubsection speak-numeral
2507
2462 @multitable @columnfractions .2 .8 2508 @multitable @columnfractions .2 .8
2463 @item Value: @tab digits | continous 2509 @item Value: @tab digits | continous
2464 @item Initial: @tab none 2510 @item Initial: @tab none
2465 @item Applies to: @tab all elements 2511 @item Applies to: @tab all elements
2466 @item Inherited: @tab yes 2512 @item Inherited: @tab yes
2467 @end multitable 2513 @end multitable
2468 2514
2469 @node speak-time, Units, speak-numeral, Speech Properties 2515 @node speak-time, , speak-numeral, Speech Properties
2470 @subsubsection speak-time 2516 @subsubsection speak-time
2517
2471 @multitable @columnfractions .2 .8 2518 @multitable @columnfractions .2 .8
2472 @item Value: @tab 24 | 12 | none 2519 @item Value: @tab 24 | 12 | none
2473 @item Initial: @tab none 2520 @item Initial: @tab none
2474 @item Applies to: @tab all elements 2521 @item Applies to: @tab all elements
2475 @item Inherited: @tab yes 2522 @item Inherited: @tab yes
2476 @end multitable 2523 @end multitable
2477 2524
2478 @node Units, Length Units, speak-time, Stylesheets 2525 @node Units, , Properties, Stylesheets
2479 @section Units 2526 @section Units
2480 2527
2481 @ifinfo
2482 @menu 2528 @menu
2483 * Length Units:: 2529 * Length Units::
2484 * Percentage Units:: 2530 * Percentage Units::
2485 * Color Units:: 2531 * Color Units::
2486 * URLs:: 2532 * URLs::
2487 * Angle Units:: 2533 * Angle Units::
2488 * Time Units:: 2534 * Time Units::
2489 @end menu 2535 @end menu
2490 @end ifinfo
2491 2536
2492 @node Length Units, Percentage Units, Units, Units 2537 @node Length Units, Percentage Units, Units, Units
2493 @subsection Length Units 2538 @subsection Length Units
2494 2539
2495 @node Percentage Units, Color Units, Length Units, Units 2540 @node Percentage Units, Color Units, Length Units, Units
2501 @node URLs, Angle Units, Color Units, Units 2546 @node URLs, Angle Units, Color Units, Units
2502 @subsection URLs 2547 @subsection URLs
2503 2548
2504 @node Angle Units, Time Units, URLs, Units 2549 @node Angle Units, Time Units, URLs, Units
2505 @subsection Angle Units 2550 @subsection Angle Units
2551
2506 These are the legal angle units: 2552 These are the legal angle units:
2507 @itemize @bullet 2553 @itemize @bullet
2508 @item 2554 @item
2509 deg: degrees 2555 deg: degrees
2510 @item 2556 @item
2511 grad 2557 grad
2512 @item 2558 @item
2513 rad: radians 2559 rad: radians
2514 @end itemize 2560 @end itemize
2515 2561
2516 @node Time Units, Supported URLs, Angle Units, Units 2562 @node Time Units, , Angle Units, Units
2517 @subsection Time Units 2563 @subsection Time Units
2564
2518 These are the legal time units: 2565 These are the legal time units:
2519 2566
2520 @itemize @bullet 2567 @itemize @bullet
2521 @item 2568 @item
2522 ms: milliseconds 2569 ms: milliseconds
2523 @item 2570 @item
2524 s: seconds 2571 s: seconds
2525 @end itemize 2572 @end itemize
2526 2573
2527 @node Supported URLs, MIME Support, Time Units, Top 2574 @node Supported URLs, MIME Support, Stylesheets, Top
2528 @chapter Supported URLs 2575 @chapter Supported URLs
2529 2576
2530 ::WORK:: List supported URL types, specific RFCs, etc. 2577 ::WORK:: List supported URL types, specific RFCs, etc.
2531 2578
2532 @ifinfo
2533 @menu 2579 @menu
2580 * file:: Local file access.
2581 * ftp:: Remote file access via ftp.
2582 * nfs:: Remote file access via NFS.
2583 * info:: Access to the Emacs Info system.
2584 * http/https:: @sc{http/1.0} support.
2585 * mailto:: Sending simple electronic mail.
2586 * news/nntp/snews:: Reading and sending Usenet news.
2587 * rlogin/telnet/tn3270:: Legacy host connections.
2588 * irc:: Internet Relay Chat.
2589 * data:: Embedding the data within the URL itself.
2590 * mailserver:: Slightly more complicated electronic mail.
2591 * gopher:: Gopher and Gopher+.
2592 * finger:: The old favorite.
2534 @end menu 2593 @end menu
2535 @end ifinfo 2594
2536 2595 @node file, ftp, Supported URLs, Supported URLs
2537 @node MIME Support, Adding MIME types based on file extensions, Supported URLs, Top 2596 @section file
2597
2598 @node ftp, nfs, file, Supported URLs
2599 @section ftp
2600
2601 @node nfs, info, ftp, Supported URLs
2602 @section nfs
2603
2604 @node info, http/https, nfs, Supported URLs
2605 @section info
2606
2607 @node http/https, mailto, info, Supported URLs
2608 @section http/https
2609
2610 @node mailto, news/nntp/snews, http/https, Supported URLs
2611 @section mailto
2612
2613 @node news/nntp/snews, rlogin/telnet/tn3270, mailto, Supported URLs
2614 @section news/nntp/snews
2615
2616 @node rlogin/telnet/tn3270, irc, news/nntp/snews, Supported URLs
2617 @section rlogin/telnet/tn3270
2618
2619 @node irc, data, rlogin/telnet/tn3270, Supported URLs
2620 @section irc
2621
2622 @node data, mailserver, irc, Supported URLs
2623 @section data
2624
2625 @node mailserver, gopher, data, Supported URLs
2626 @section mailserver
2627
2628 @node gopher, finger, mailserver, Supported URLs
2629 @section gopher
2630
2631 @node finger, , gopher, Supported URLs
2632 @section finger
2633
2634 @node MIME Support, Security, Supported URLs, Top
2538 @chapter MIME Support 2635 @chapter MIME Support
2539 @sc{mime} is an emerging standard for multimedia mail. It offers a very 2636 @sc{mime} is an emerging standard for multimedia mail. It offers a very
2540 flexible typing mechanism. The type of a file or message is specified 2637 flexible typing mechanism. The type of a file or message is specified
2541 in two parts, separated by a '/'. The first part is the general 2638 in two parts, separated by a '/'. The first part is the general
2542 category of the data (text, application, image, etc.). The second part 2639 category of the data (text, application, image, etc.). The second part
2550 servers can now send back content-type headers in response to a request, 2647 servers can now send back content-type headers in response to a request,
2551 and not have the client second-guess it based on file extensions. @sc{html} 2648 and not have the client second-guess it based on file extensions. @sc{html}
2552 files can now be named @file{something.png} (not a great idea, but 2649 files can now be named @file{something.png} (not a great idea, but
2553 possible). 2650 possible).
2554 2651
2555 @ifinfo
2556 @menu 2652 @menu
2557 * Adding MIME types based on file extensions:: How to map file 2653 * Adding MIME types based on file extensions:: How to map file
2558 extensions onto MIME 2654 extensions onto MIME
2559 types (e.g., @samp{.png -> 2655 types (e.g., @samp{.png ->
2560 image/png)}. 2656 image/png)}.
2561 * Specifying Viewers:: How to specify external and internal viewers 2657 * Specifying Viewers:: How to specify external and internal viewers
2562 for files that Emacs-W3 cannot handle natively. 2658 for files that Emacs-W3 cannot handle natively.
2563 @end menu 2659 @end menu
2564 @end ifinfo
2565 2660
2566 @node Adding MIME types based on file extensions, Specifying Viewers, MIME Support, MIME Support 2661 @node Adding MIME types based on file extensions, Specifying Viewers, MIME Support, MIME Support
2567 @section Adding MIME types based on file extensions 2662 @section Adding MIME types based on file extensions
2663
2568 @vindex mm-mime-extensions 2664 @vindex mm-mime-extensions
2569 For some protocols however, it is still necessary to guess the content 2665 For some protocols however, it is still necessary to guess the content
2570 of a file based on the file extension. This type of guess-work should 2666 of a file based on the file extension. This type of guess-work should
2571 only be needed when accessing files via @sc{ftp}, local file access, or old 2667 only be needed when accessing files via @sc{ftp}, local file access, or old
2572 @sc{http}/0.9 servers. 2668 @sc{http}/0.9 servers.
2617 2713
2618 type/subtype is the MIME-like type of the document. ext* is any number 2714 type/subtype is the MIME-like type of the document. ext* is any number
2619 of space-separated filename extensions which correspond to the MIME 2715 of space-separated filename extensions which correspond to the MIME
2620 type. 2716 type.
2621 2717
2622 @node Specifying Viewers, ,Adding MIME types based on file extensions, MIME Support 2718 @node Specifying Viewers, , Adding MIME types based on file extensions, MIME Support
2623 @section Specifying Viewers 2719 @section Specifying Viewers
2720
2624 Not all files look as they should when parsed as an @sc{html} document 2721 Not all files look as they should when parsed as an @sc{html} document
2625 (whitespace is stripped, paragraphs are reformatted, and lots of little 2722 (whitespace is stripped, paragraphs are reformatted, and lots of little
2626 changes that make the document look unrecognizable). Files may be 2723 changes that make the document look unrecognizable). Files may be
2627 passed to external programs or Emacs Lisp functions to be viewed. 2724 passed to external programs or Emacs Lisp functions to be viewed.
2628 2725
2637 arguments, the major type ("@i{image}"), the minor type ("@i{png}"), and 2734 arguments, the major type ("@i{image}"), the minor type ("@i{png}"), and
2638 an assoc list of information about the viewer. Please see the @sc{url} 2735 an assoc list of information about the viewer. Please see the @sc{url}
2639 documentation for more specific information on what this assoc list 2736 documentation for more specific information on what this assoc list
2640 should look like. 2737 should look like.
2641 2738
2642 @node Security, Non-Unix Operating Systems, , Top 2739 @node Security, Non-Unix Operating Systems, MIME Support, Top
2643 @chapter Security 2740 @chapter Security
2644 @cindex Security 2741 @cindex Security
2645 @cindex Paranoia 2742 @cindex Paranoia
2646 There are an increasing number of ways to authenticate a user to a web 2743 There are an increasing number of ways to authenticate a user to a web
2647 service. Emacs-W3 tries to support as many as possible. Emacs-W3 2744 service. Emacs-W3 tries to support as many as possible. Emacs-W3
2676 Communications @footnote{http://www.netscape.com/}. Emacs-W3 supports 2773 Communications @footnote{http://www.netscape.com/}. Emacs-W3 supports
2677 @sc{http} transfers over an SSL encrypted channel, if the appropriate files 2774 @sc{http} transfers over an SSL encrypted channel, if the appropriate files
2678 have been installed.@xref{Installing SSL} 2775 have been installed.@xref{Installing SSL}
2679 @end table 2776 @end table
2680 2777
2681 @node Non-Unix Operating Systems, VMS, Security, Top 2778 @node Non-Unix Operating Systems, Speech Integration, Security, Top
2682 @chapter Non-Unix Operating Systems 2779 @chapter Non-Unix Operating Systems
2683 @cindex Non-Unix Operating Systems 2780 @cindex Non-Unix Operating Systems
2684 @ifinfo 2781
2685 @menu 2782 @menu
2686 * VMS:: The wonderful world of VAX|AXP-VMS! 2783 * VMS:: The wonderful world of VAX|AXP-VMS!
2687 * OS/2:: The next-best thing to Unix. 2784 * OS/2:: The next-best thing to Unix.
2688 * MS-DOS:: The wonderful world of MS-DOG! 2785 * MS-DOS:: The wonderful world of MS-DOG!
2689 * Windows:: Windows NT, Chicago/Windows 95. 2786 * Windows:: Windows NT, Chicago/Windows 95.
2690 @end menu 2787 @end menu
2691 @end ifinfo
2692 2788
2693 @node VMS, OS/2, Non-Unix Operating Systems, Non-Unix Operating Systems 2789 @node VMS, OS/2, Non-Unix Operating Systems, Non-Unix Operating Systems
2694 @section VMS 2790 @section VMS
2695 @cindex VAX-VMS 2791 @cindex VAX-VMS
2696 @cindex AXP-VMS 2792 @cindex AXP-VMS
2697 @cindex Digital VMS 2793 @cindex Digital VMS
2698 @cindex VMS 2794 @cindex VMS
2795
2699 :: WORK :: VMS Specific instriuctions 2796 :: WORK :: VMS Specific instriuctions
2700 2797
2701 @node OS/2, MS-DOS, VMS, Non-Unix Operating Systems 2798 @node OS/2, MS-DOS, VMS, Non-Unix Operating Systems
2702 @section OS/2 2799 @section OS/2
2703 @cindex OS/2 2800 @cindex OS/2
2704 @cindex Warp 2801 @cindex Warp
2802
2705 :: WORK :: OS/2 Specific instructions 2803 :: WORK :: OS/2 Specific instructions
2706 2804
2707 @node MS-DOS, Windows, OS/2, Non-Unix Operating Systems 2805 @node MS-DOS, Windows, OS/2, Non-Unix Operating Systems
2708 @section MS-DOS 2806 @section MS-DOS
2709 @cindex MS-DOS 2807 @cindex MS-DOS
2710 @cindex Microsloth 2808 @cindex Microsloth
2711 @cindex DOS 2809 @cindex DOS
2712 @cindex MS-DOG 2810 @cindex MS-DOG
2811
2713 :: WORK :: DOS Specific instructions 2812 :: WORK :: DOS Specific instructions
2714 2813
2715 @node Windows, Speech Integration , MS-DOS, Non-Unix Operating Systems 2814 @node Windows, , MS-DOS, Non-Unix Operating Systems
2716 @section Windows 2815 @section Windows
2717 @cindex Windows (32-Bit) 2816 @cindex Windows (32-Bit)
2718 @cindex 32-Bit Windows 2817 @cindex 32-Bit Windows
2719 @cindex Microsloth 2818 @cindex Microsloth
2720 @cindex Windows '95 2819 @cindex Windows '95
2820
2721 :: WORK :: 32bit Windows Specific instructions 2821 :: WORK :: 32bit Windows Specific instructions
2722 2822
2723 @node Speech Integration, Advanced Features, Windows, Top 2823 @node Speech Integration, Advanced Features, Non-Unix Operating Systems, Top
2724 @chapter Speech Integration 2824 @chapter Speech Integration
2825
2725 :: WORK :: Emacspeak integration 2826 :: WORK :: Emacspeak integration
2726 2827
2727 @node Advanced Features, Style Sheets, Speech Integration, Top 2828 @node Advanced Features, More Help, Speech Integration, Top
2728 @chapter Advanced Features 2829 @chapter Advanced Features
2729 2830
2730 @ifinfo
2731 @menu 2831 @menu
2732 * Style Sheets:: Formatting control, the right way 2832 * Disk Caching:: Improving performance by using a local disk cache
2733 * Disk Caching:: Improving performance by using a local disk cache 2833 * Interfacing to Mail/News:: How to make VM understand hypertext links
2734 * Interfacing to Mail/News:: How to make VM understand hypertext links 2834 * Debugging HTML:: How to make Emacs-W3 display warnings about invalid
2735 * Debugging HTML:: How to make Emacs-W3 display warnings about invalid 2835 @sc{html}/@sc{html}+ constructs.
2736 @sc{html}/@sc{html}+ constructs. 2836 * Hooks:: Various hooks to use throughout Emacs-W3
2737 * Native WAIS Support:: How to make Emacs-W3 understand WAIS links without 2837 * Other Variables:: Miscellaneous variables that control the real
2738 using a gateway. 2838 guts of Emacs-W3.
2739 * Rating Links:: How to make Emacs-W3 put an 'interestingness' value
2740 next to each link.
2741 * Gopher Plus Support:: How Emacs-W3 makes use of the Gopher+ protocol.
2742 * Hooks:: Various hooks to use throughout Emacs-W3
2743 * Other Variables:: Miscellaneous variables that control the real
2744 guts of Emacs-W3.
2745 @end menu 2839 @end menu
2746 @end ifinfo 2840
2747 2841 @node Disk Caching, Interfacing to Mail/News, Advanced Features, Advanced Features
2748 @node Style Sheets, Disk Caching, Advanced Features, Advanced Features
2749 @section Style Sheets
2750 @cindex Formatting control
2751 @cindex Style sheets
2752 @cindex Look and Feel
2753 @cindex Layout control
2754 @cindex Experimental style sheet mechanism
2755 Emacs-W3 currently supports the experimental style sheet mechanism
2756 proposed by H&kon W. Lie of the W3 Consortium. This allows for the
2757 author to specify what a document should look like, and yet allow the
2758 end user to override any of the stylistic changes. This allows for
2759 people with special needs (most notably the visually impaired) to
2760 override style bindings that could make a document totally
2761 unreadable.
2762
2763 @example
2764 <style notation="css">
2765 /* This is a comment
2766 ** These will be ignored, up to the terminating */
2767
2768 h1 @{ align: center,
2769 color: yellow,
2770 background: red,
2771 font-size: 24pt
2772 @}
2773 h2 @{ align: right,
2774 font-family: palatino,
2775 font-size: 18pt
2776 @}
2777 </style>
2778 @end example
2779
2780 :: WORK :: Much more information on stylesheets
2781
2782 @cindex <style>
2783 To include a stylesheet into a document, simply use the <style> tag.
2784 Use the @b{notation} attribute to specify what language the stylesheet
2785 is specified in. The default is @b{css}. The data between the <style>
2786 and </style> tags is the stylsheet proper - no @sc{html} parsing is done to
2787 this data - it is treated similar to an <XMP> section of text. To
2788 reference an external stylesheet, use the <link> tag.
2789 @example
2790 <link rel="stylesheet" href="/bill.style">
2791 @end example
2792 If these two mechanisms are mixed, then the @sc{url} is resolved first, and
2793 the contents of the <style> tag take precedence if there are any
2794 conflicting directives.
2795
2796 @cindex DSSSL
2797 @cindex DSSSL-lite
2798 In the future, DSSSL and DSSSL-lite will be supported as valid
2799 stylesheet languages, but not in this release. For more information on
2800 DSSSL-lite see http://www.falch.no/~pepper/DSSSL-Lite/ - for more
2801 information on full DSSSL, see
2802 ftp://ftp.jclark.com/pub/dsssl/dsssl.ps.gz
2803
2804 @node Disk Caching, Interfacing to Mail/News, Style Sheets, Advanced Features
2805 @section Disk Caching 2842 @section Disk Caching
2806 @cindex Caching 2843 @cindex Caching
2807 @cindex Persistent Cache 2844 @cindex Persistent Cache
2808 @cindex Disk Cache 2845 @cindex Disk Cache
2846
2809 A cache stores the information on a page on the local machine. When 2847 A cache stores the information on a page on the local machine. When
2810 requesting a page that is in the cache, Emacs-W3 can retrieve the page 2848 requesting a page that is in the cache, Emacs-W3 can retrieve the page
2811 from the cache more quickly than retrieving the page again from its 2849 from the cache more quickly than retrieving the page again from its
2812 location out on the network. With a well-populated cache, browsing the 2850 location out on the network. With a well-populated cache, browsing the
2813 web is dramatically faster. 2851 web is dramatically faster.
2889 @cindex Using Emacs-W3 with VM 2927 @cindex Using Emacs-W3 with VM
2890 @cindex GNUS 2928 @cindex GNUS
2891 @cindex Using Emacs-W3 with Gnus 2929 @cindex Using Emacs-W3 with Gnus
2892 @cindex RMAIL 2930 @cindex RMAIL
2893 @cindex Using Emacs-W3 with RMAIL 2931 @cindex Using Emacs-W3 with RMAIL
2932
2894 More and more people are including @sc{url}s in their signatures, and within 2933 More and more people are including @sc{url}s in their signatures, and within
2895 the body of mail messages. It can get quite tedious to type these into 2934 the body of mail messages. It can get quite tedious to type these into
2896 the minibuffer to follow one. 2935 the minibuffer to follow one.
2897 2936
2898 @vindex browse-url-browser-function 2937 @vindex browse-url-browser-function
2910 (lambda () 2949 (lambda ()
2911 (define-key rmail-mode-map [mouse-2] 'w3-maybe-follow-link-mouse) 2950 (define-key rmail-mode-map [mouse-2] 'w3-maybe-follow-link-mouse)
2912 (define-key rmail-mode-map "\r" 'w3-maybe-follow-link)))) 2951 (define-key rmail-mode-map "\r" 'w3-maybe-follow-link))))
2913 @end example 2952 @end example
2914 2953
2915 @node Debugging HTML, Native WAIS Support, Interfacing to Mail/News, Advanced Features 2954 @node Debugging HTML, Hooks, Interfacing to Mail/News, Advanced Features
2916 @section Debugging HTML 2955 @section Debugging HTML
2917 @cindex Debugging 2956 @cindex Debugging
2918 @cindex Invalid HTML 2957 @cindex Invalid HTML
2919 @cindex Bad HTML 2958 @cindex Bad HTML
2920 @vindex w3-debug-buffer 2959 @vindex w3-debug-buffer
2921 @vindex w3-debug-html 2960 @vindex w3-debug-html
2961
2922 For those people that are adventurous, or are just as anal as I am about 2962 For those people that are adventurous, or are just as anal as I am about
2923 people writing valid @sc{html}, set the variable @code{w3-debug-html} to 2963 people writing valid @sc{html}, set the variable @code{w3-debug-html} to
2924 @code{t} and see what happens. 2964 @code{t} and see what happens.
2925 2965
2926 2966
2928 message is displayed. 2968 message is displayed.
2929 2969
2930 :: WORK :: Need to list the different values w3-debug-html can have, and 2970 :: WORK :: Need to list the different values w3-debug-html can have, and
2931 :: WORK :: what they do :: 2971 :: WORK :: what they do ::
2932 2972
2933 @node Native WAIS Support, Rating Links, Debugging HTML, Advanced Features 2973 @node Hooks, Other Variables, Debugging HTML, Advanced Features
2934 @section Native WAIS Support
2935 This version of Emacs-W3 supports native WAIS querying (earlier
2936 versions required the use of a gateway program). In order to use the
2937 native WAIS support, a working @dfn{waisq} binary is required. I
2938 recommend the distribution from think.com -
2939 ftp://think.com/wais/wais-8-b6.1.tar.Z is a good place to start.
2940
2941 @vindex url-waisq-prog
2942 @vindex url-wais-gateway-server
2943 @vindex url-wais-gateway-port
2944 The variable @code{url-waisq-prog} must point to this executable, and
2945 one of @code{url-wais-gateway-server} or @code{url-wais-gateway-port}
2946 should be @code{nil}.
2947
2948 When a WAIS @sc{url} is encountered, a form will be automatically generated
2949 and displayed. After typing in the search term, the query will be sent
2950 to the server by running the @code{url-waisq-prog} in a subprocess. The
2951 results will be converted into @sc{html} and displayed.
2952
2953 @node Rating Links, Gopher Plus Support, Native WAIS Support, Advanced Features
2954 @section Rating Links
2955 The @code{w3-link-info-display-function} variable can be used to 'rate' a @sc{url}
2956 when it shows up in an @sc{html} page. If non-@code{nil}, then this should
2957 be a list specifying (or a symbol specifying the name) of a function.
2958 This function should expect one argument, a fully specified @sc{url}, and
2959 should return a string. This string is inserted after the link
2960 text.
2961
2962 If a user has decided that all links served from blort.com are too laden
2963 with images, and wants to be warned that a link points at this host,
2964 they could do something like this:
2965
2966 @example
2967 (defun check-url (url)
2968 (if (string-match "://[^/]blort.com" url)
2969 "[SLOW!]" ""))
2970
2971 (setq w3-link-info-display-function 'check-url)
2972 @end example
2973
2974 So that all links pointing to any site at blort.com shows up as "Some
2975 link[SLOW!]" instead of just "Some link".
2976
2977 @node Gopher Plus Support, Hooks, Rating Links, Advanced Features
2978 @section Gopher+ Support
2979 @cindex Gopher+
2980 The gopher+ support in Emacs-W3 is limited to the conversion of ASK
2981 blocks into @sc{html} 3.0 forms, and the usage of the content-length given by
2982 the gopher+ server to give a nice status bar on the bottom of the
2983 screen.
2984
2985 This will hopefully be extended to include the Gopher+ method of
2986 content-type negotiation, but this may be a while.
2987
2988 @node Hooks, Other Variables, Gopher Plus Support, Advanced Features
2989 @section Hooks 2974 @section Hooks
2990 @cindex Hooks 2975 @cindex Hooks
2976
2991 These are the various hooks that can be used to customize some of 2977 These are the various hooks that can be used to customize some of
2992 Emacs-W3's behavior. They are arranged in the order in which they would 2978 Emacs-W3's behavior. They are arranged in the order in which they would
2993 happen when retrieving a document. All of these are functions (or lists 2979 happen when retrieving a document. All of these are functions (or lists
2994 of functions) that are called consecutively. 2980 of functions) that are called consecutively.
2995 2981
3015 before any inlined images are downloaded and converted. 3001 before any inlined images are downloaded and converted.
3016 @item w3-source-file-hooks 3002 @item w3-source-file-hooks
3017 These hooks are run after displaying a document's source 3003 These hooks are run after displaying a document's source
3018 @end table 3004 @end table
3019 3005
3020 @node Other Variables, , Hooks, Advanced Features 3006 @node Other Variables, , Hooks, Advanced Features
3021 @section Miscellaneous variables 3007 @section Miscellaneous variables
3008
3022 There are lots of variables that control the real nitty-gritty of Emacs-W3 3009 There are lots of variables that control the real nitty-gritty of Emacs-W3
3023 that the beginning user probably shouldn't mess with. Here they are. 3010 that the beginning user probably shouldn't mess with. Here they are.
3024 3011
3025 @table @code 3012 @table @code
3026 @item url-bad-port-list 3013 @item url-bad-port-list
3114 @item url-uncompressor-alist 3101 @item url-uncompressor-alist
3115 @vindex url-uncompressor-alist 3102 @vindex url-uncompressor-alist
3116 An assoc list of file extensions and the appropriate uncompression 3103 An assoc list of file extensions and the appropriate uncompression
3117 programs for each. This is used to build the Accept-encoding header for 3104 programs for each. This is used to build the Accept-encoding header for
3118 @sc{http}/1.0 requests. 3105 @sc{http}/1.0 requests.
3119 @item url-waisq-prog
3120 @vindex url-waisq-prog
3121 Name of the waisq executable on this system. This should be the
3122 @file{waisq} program from think.com's wais8-b5.1 distribution.
3123 @end table 3106 @end table
3124 3107
3125 @node More Help, Future Directions, , Top 3108 @node More Help, Future Directions, Advanced Features, Top
3126 @chapter More Help 3109 @chapter More Help
3127 @cindex Relevant Newsgroups 3110 @cindex Relevant Newsgroups
3128 @cindex Newsgroups 3111 @cindex Newsgroups
3129 @cindex Support 3112 @cindex Support
3130 For more help on Emacs-W3, please send me mail 3113 For more help on Emacs-W3, please send me mail
3429 @example 3412 @example
3430 (setq url-proxy-services '(("http" . "http://proxy.aventail.com/") 3413 (setq url-proxy-services '(("http" . "http://proxy.aventail.com/")
3431 ("no_proxy" . "^.*\\(aventail\\|seanet\\)\.com"))) 3414 ("no_proxy" . "^.*\\(aventail\\|seanet\\)\.com")))
3432 @end example 3415 @end example
3433 3416
3434 @node Installing SSL, Mailcap Files, Proxy Gateways, Top 3417 @node Installing SSL, Mailcap Files, Proxy Gateways, Top
3435 @appendix Installing SSL 3418 @appendix Installing SSL
3436 @cindex HTTP/1.0 Authentication 3419 @cindex HTTP/1.0 Authentication
3437 @cindex Secure Sockets Layer 3420 @cindex Secure Sockets Layer
3438 @cindex SSL 3421 @cindex SSL
3439 @cindex Gag Puke Retch 3422 @cindex Gag Puke Retch
3607 :: WORK :: Document how you can never see another ad from them again 3590 :: WORK :: Document how you can never see another ad from them again
3608 3591
3609 @node General Index, Key Index, Down with DoubleClick, Top 3592 @node General Index, Key Index, Down with DoubleClick, Top
3610 @appendix General Index 3593 @appendix General Index
3611 @printindex fn 3594 @printindex fn
3612 @node Key Index, , General Index, Top 3595 @node Key Index, , General Index, Top
3613 @appendix Key Index 3596 @appendix Key Index
3614 @printindex ky 3597 @printindex ky
3615 @contents 3598 @contents
3616 @bye 3599 @bye
3617
3618 @c @node Supported Protocols, , Stylesheets, Introduction
3619 @c @chapter Supported Protocols
3620 @c @cindex Network Protocols
3621 @c @cindex Protocols Supported
3622 @c @cindex Supported Protocols
3623 @c Emacs-W3 supports the following protocols
3624 @c @table @b
3625 @c @item Usenet News
3626 @c Can either display an entire newsgroup or specific articles by
3627 @c Message-ID: header. Instead of rewriting a newsreader, this integrates
3628 @c with the Gnus newsreader. It requires at least Gnus 5.0, but it is
3629 @c always safest to use the latest version. Gnus supports some very
3630 @c advanced features, including virtual newsgroups, mail and news
3631 @c integration, and reading news from multiple servers. @inforef{Gnus,
3632 @c Top,gnus}, for more info.
3633
3634 @c To be more in line with the other @sc{url} schemes, the hostname and port of
3635 @c an @sc{nntp} server can be specified. @sc{url}s of the form
3636 @c news://hostname:port/messageID work, but might not work in some other
3637 @c browsers.
3638
3639 @c @item @sc{http}
3640 @c Supports the @sc{http}/0.9, @sc{http}/1.0, and parts of the @sc{http}/1.1 protocols.
3641 @c @item Gopher
3642 @c Support for all gopher types, including CSO queries.
3643 @c @item Gopher+
3644 @c Support for Gopher+ retrievals. Support for converting ASK blocks into
3645 @c HTML forms and submitting them back to the server.
3646 @c @item @sc{ftp}
3647 @c @sc{ftp} is handled by either ange-ftp or efs.
3648 @c @inforef{Ange-FTP,Top,ange-ftp}, for more information on Ange-FTP, or
3649 @c @inforef{EFS, Top,efs}, for information on EFS.
3650 @c @item Local files
3651 @c Local files are of course handled, and MIME content-types are derived
3652 @c from the file extensions.
3653 @c @item telnet, tn3270, rlogin
3654 @c Telnet, tn3270, and rogin are handled by running the appropriate program
3655 @c in an emacs buffer, or running an external process.
3656 @c @item mailto
3657 @c Causes a mail message to be started to a specific address. Supports the
3658 @c Netscape @i{extensions} to specify arbitrary headers on the message.
3659 @c @item data
3660 @c A quick and easy way to `inline' small pieces of information that you do
3661 @c not necessarily want to download over the net separately. Can speed up
3662 @c display of small icons, stylesheet information, etc. See the internet
3663 @c draft draft-masinter-url-data-02.txt for more information.
3664 @c @item mailserver
3665 @c A more powerful version of mailto, which allows the author to specify
3666 @c the subject and body text of the mail message. This type of link is
3667 @c never fully executed without user confirmation, because it is possible
3668 @c to insert insulting or threatening (and possibly illegal) data into the
3669 @c message. The mail message is displayed, and the user must confirm the
3670 @c message before it is sent.
3671 @c @item x-exec
3672 @c A @sc{url} can cause a local executable to be run, and its output interpreted
3673 @c as if it had come from an @sc{http} server. This is very useful, but is
3674 @c still an experimental protocol, hence the X- prefix. This @sc{url} protocol
3675 @c is deprecated, but might be useful in the future.
3676 @c @item @sc{nfs}
3677 @c Retrieves information over @sc{nfs}. This requires that your operating
3678 @c system support auto-mounting of @sc{nfs} volumes.
3679 @c @item finger
3680 @c Retrieves information about a user via the 'finger' protocol.
3681 @c @item Info
3682 @c Creates a link to an GNU-style info file. @inforef{Info,Top,info}, for more
3683 @c information on the Info format.
3684 @c @item SSL
3685 @c SSL requires a set of patches to the Emacs C code and SSLRef 2.0, or an
3686 @c external program to run in a subprocess (similar to the @file{tcp.el}
3687 @c package that comes with GNUS. @xref{Installing SSL}
3688 @c @end table
3689