ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/Changes
Revision: 1.198
Committed: Thu Jul 24 20:35:37 2008 UTC (15 years, 9 months ago) by root
Branch: MAIN
Changes since 1.197: +2 -1 lines
Log Message:
use key_random_map

File Contents

# User Rev Content
1 root 1.36 Deliantra MORPG Server, Maps and Archetypes ChangeLog.
2 root 1.6
3 root 1.192 TODO: emergency swap mode is not working
4     TODO: xs-warn doesn't end up in server log.
5     TODO: maybe move gsay to the main chat channel?
6     TODO: 2008-07-13 00:41:27.8762 BUG: process_events(): removed object is on active list: {cnt:8720978,uuid:<1.37c8d364d>,name:"bomb",flags:[2,11],type:102}
7    
8 elmex 1.197 - made jeweler workbench larger and some other minor map
9     changes in jeweler town.
10 root 1.196 - fixed wrong item handling in jeweler skill code.
11 root 1.198 - (arch) use a special "key_random_map" for random map keys
12     that are used up.
13 elmex 1.195
14 root 1.193 2.6 Sun Jul 20 18:58:08 CEST 2008
15 elmex 1.181 - (maps) extension of the jeweler quest/skill/town
16 root 1.179 - correctly move gsay to the party channel.
17 root 1.178 - fix a crash when animate weapon was used in some areas.
18 elmex 1.177 - fixed unnecessary identification of by converters created objects.
19 elmex 1.176 - (maps) tutorial now contains clues about chatting and talking
20     with NPCs.
21 elmex 1.175 - (arch) dragon scales got proper type now
22 root 1.193 - object::decrease would sometimes cause container weights to
23     be wrong, this has been fixed.
24 root 1.194 - do not send time updates for newly-seen items.
25 root 1.185 - thawing an icecube will once more drop its contents to the ground.
26 root 1.183 - fix cone spells etc. going through walls sometimes.
27 root 1.186 - fix a weight update bug that sometimes left containers
28     with wrong weights.
29 root 1.194 - added auto_apply event and extension for shop tiles.
30 root 1.172 - work around get_map_flags invoking perl and switching the stack.
31     - make sure the map is loaded when using a town portal return.
32 elmex 1.171 - fixed a bug with caching of sp/grace/food points for spells
33     where healing spells didn't cost any grace.
34 root 1.173 - fix starvation kill reason.
35 root 1.174 - fix pk killer name message.
36 root 1.189 - don't let people apply signs with @match.
37 root 1.190 - add support for berkeley db 4.7 (the new BDB module also fixes
38     what seems to be the biggets memleak in the server).
39 elmex 1.171
40 root 1.170 2.56 Wed Jun 4 10:50:40 CEST 2008
41 root 1.168 - require Coro 4.73 which contains an important performance-bugfix.
42     - use anyevent to manage listen ports (this enables IPv6 support).
43 root 1.167 - server supports ipv6 client connections now.
44 root 1.168 - use newly-available Coro::AnyEvent.
45 root 1.169 - get rid of the AnyEvent::AIO watcher, start the event thread earlier
46     to let it handle AIO requests.
47 root 1.167
48 root 1.166 2.55 Sat May 24 19:52:52 CEST 2008
49 root 1.165 - avoid newmap commands when crossing tiled map boundaries. this speeds up
50     processing considerably (especially in the client) and reduces data transfers
51     (saves roughly 1kb each crossing in typical configs). works even with gcfclient.
52 root 1.162 - (arch) fix typo in ixalovh treasurelist causing empty_archetypes to appear.
53     - (map) fixed npc dialogue in pup_land/s_f/special.
54     - bugfix: fix a crash when a player casts a swarm spell and then logs out
55     (swarm spells now stay in the player's inventory).
56 root 1.159 - bugfix: when unapplying skills also remove them from the range/combat slots.
57 root 1.162 - bugfix: do not merge items whose archetype name merges, use the
58     archetype *archname* (chairs of different facings were merged).
59     - bugfix: fix a potential crash issue in find_object_name (not used
60     normally).
61 root 1.164 - bugfix: locked doors cnanot be bashed down by magical means
62     (destruction, magic missile etc.).
63 root 1.163 - swarm spells without a direction now use various spiral patterns
64     instead of being fully random.
65 root 1.158 - update AnyEvent API to 3.4 and above.
66 root 1.156
67 root 1.155 2.54 Thu May 8 22:01:22 CEST 2008
68 root 1.146 - change floorbox item ordering to enable more efficient protocol and to
69 root 1.140 stay in sync with the 0.9971 client update which also reverses ordering.
70 root 1.152 - bugfix: the jumping skill now gives experience for jumping
71     and for attacking monsters. it also takes about one second to do a jump.
72 root 1.138 - bugfix: players couldn't starve in 2.53 :(
73 root 1.136 - bugfix: correctly send the client a del_spell when a spell gets removed.
74 root 1.152 - bugfix: spell effects like word of recall are removed on death.
75 root 1.141 - bugfix: fix a crash when objects with treasure on top (ground...)
76     were created outside a map.
77 root 1.145 - bugfix: couldn't apply inventory items when levitating, but ground items
78     (fixed by reversing the logic).
79 root 1.152 - bugfix: fixed a mismatched '"' in the debugging description of objects
80 root 1.153 - bugfix: the random map generator no longer leaks key objects.
81 root 1.154 - bugfix: support random maps >127x127.
82 root 1.152 - (maps) fixed the death certificate system in nimbus.
83 root 1.159 - (maps) rebalance onefang, build a road to onefang, temporarily closed zorn.
84 root 1.152 - (arch) the material 'wood' was undefined, it's now a burnable material.
85 root 1.147 - (arch) give ball lightning a real name.
86 root 1.152 - (arch) fixed material of bones (was 'wood', is now 'bone')
87 root 1.155 - support cfpod in ex replies (client item tooltips).
88 root 1.143 - unapply item in range slow when readying a spell.
89 root 1.148 - bugfix: account for rounding errors in weight updates.
90 root 1.139 - remove synchronous mkdir in chargen_race_done.
91     - fix per-race starting maps.
92 root 1.142 - check hiscore on suicide and quit as well.
93 root 1.138 - tell players when they are starving.
94 root 1.133 - get rid of costly object_from_name conversion for altar effects.
95     - fix map difficulty calculation for generators.
96 root 1.146 - slightly more intelligent handling of "is_animated" flag.
97 root 1.149 - support no_drop map header flag (before it was only available internally).
98 root 1.153 - make random-map-generated keys crumble after one hour, use more unique slaying.
99 root 1.133
100 root 1.130 2.53 Sun May 4 17:32:48 CEST 2008
101 root 1.119 - bugfix: custom skill settings were not saved by the server.
102     - bugfix: remove did not actually remove items from the inventory, leaving
103 root 1.116 ghost items.
104 root 1.119 - bugfix: properly update items identified on the ground.
105 root 1.120 - bugfix: use localtime_r in the logger thread.
106 root 1.122 - bugfix: player starvation will now give the correct kill reason.
107     - bugfix: archetype reloads could crash the server.
108 root 1.119 - bugfix: the mailscrolls are now correctly handed out even when the destination
109 elmex 1.114 player is not logged in.
110 root 1.119 - bugfix: make list_logins non-blocking (glaring oversight). this caused the lag at
111 root 1.117 server startup.
112 root 1.128 - bugfix: fix the door surround check in the random map generator.
113     - (maps) fix heaven quest difficulty progression.
114     - (maps) fix some random map styles.
115     - dropping items a shop is not interested in won't sell them anymore.
116     - rods and horns with a too low maximum charge allow now at least one discharge.
117     - implement kill & death statistics.
118     - random map preparation is no longer synchronous.
119     - rewrite find_style in perl, no longer does synchronous I/O.
120     - improve random map specials placement.
121     - make the killer a real object pointer instead of a string, improved
122     kill reason messages.
123 root 1.117 - take advantage of new aio_close and aio_chmod.
124 root 1.128 - implement archetype::get, object::deep_clone and update callers.
125 root 1.125 - change_abil is much faster.
126 root 1.126 - update the floorbox more often to work around the reverses item order
127     display in clients.
128 root 1.125 - cleaned up object copying by encapsulating it to a single place.
129 root 1.126 - add hints to the invite messages.
130 root 1.127 - rewrote key<->value pair handling.
131 root 1.128 - use an independent random number generator for the random map generator.
132 elmex 1.113
133 root 1.112 2.52 Thu Apr 24 11:47:19 CEST 2008
134 root 1.106 - completely automate the item add/delete on remove/insert. this should fix
135     all "ghost" item bugs caused by sloppy coding, as sloppy coding is now correct :)
136     - completely automate the weight handling, should fix all weight
137     accounting bugs caused by sloppy coding, as sloppy coding is now correct :)
138 root 1.103 - reloading archetypes while a user was in the character creation phase
139     could crash the server.
140 root 1.106 - fix a nontrivial number of cases of code commented similar
141     to "is this really correct?", as many of those cases are now handles
142     automatically by lower level code.
143     - replace many ad-hoc checks for client visibility by object::visible_to,
144     should result in broader applicability of functions using it.
145 root 1.104 - merge items with different arch pointers refering to the same arch
146     (due to archetype reloads).
147 root 1.106 - refactored the object remove/insert functions and most related
148     functions (decrease, split, merge_ob etc.).
149 root 1.105 - make it compile better on freebsd (reported by pippijn).
150 root 1.106 - remove GT_UPDATE_INV (no longer applicable).
151 root 1.108 - fix the longstanding "container stays open" bug.
152 root 1.107 - improved floorbox updating to be incremental and other protocol
153     optimisations.
154     - get rid of update_after_inventory_change and only do update stats
155     for weight once/tick/player at max.
156 root 1.109 - rewrite party commands, use party channel.
157 root 1.103
158 root 1.102 2.51 Sun Apr 20 21:27:37 CEST 2008
159 root 1.97 - properly link against libgthread as that is needed to make the slice
160     allocator thread-safe.
161 root 1.91 - support perls not compiled with 64 bit support (though this is not a
162     recommended configuration) (reported by Samuel Gondouin).
163 root 1.94 - always put godgiven items into the player inventory, never any containers.
164 root 1.92 - (maps, arch) the scorn go club was founded!
165 root 1.93 - (arch) do no longer support player abilities, they didn't work anyways.
166 root 1.100 - (arch) the alchemy spell is now of the alchemy spell school, which
167     became a real spell-class.
168 root 1.102 - (arch) the alchemist class now get an alchemy spell book for new characters.
169     - (arch) considerably strengthened spark shower and destruction.
170     - match archetypes by name, not by ptr, in treasure.C, this makes archetypes
171     finally reloadable at runtime.
172     - changed archetype loading algorithm to only require one pass and
173     use delayed resolving of references.
174 root 1.101 - examine command now uses the examine infobox.
175 root 1.102 - implement an "incremental garbage collector" for archetypes.
176 root 1.98 - enable slice allocator again.
177 root 1.96 - implement optional free memory poisoning.
178 root 1.91
179 root 1.89 2.5 Wed Apr 16 15:06:53 CEST 2008
180 root 1.90 - the two handed weapon skill can no longer be used as unarmed combat
181 root 1.85 skill.
182 root 1.84 - append [drop xxx coins] to altar/trigger_altar/identify_table/converter
183     names (also update all maps to use money instead of coins).
184 root 1.78 - add uuid accessors to perl.
185     - add coin names and archetype accessors to perl.
186 root 1.80 - fix runtime uuid file format to use "." instead of ",".
187 root 1.78 - change perl extensions to not use hardcoded coins and values.
188 root 1.79 - write uuids asynchronously (no hiccups due to uuid writes)
189     and be more parsimonous of uuid usage by the exact value out on exit.
190 root 1.86 - write log messages in another thread, removing another sync point.
191     - support multi-line log messages in a nicer way.
192 root 1.80 - be more portable w.r.t. uuids and format specifiers everywhere.
193 root 1.81 - fix a minor memleak in the random map generator.
194     - some parts of the random map generator are not coroutine-safe,
195     so only call it "single-threaded".
196     - major cleanup of memory management in random map generator.
197 root 1.87 - slight refactoring of the random map generator, faster too.
198 root 1.81 - solve the "slice_alloc becomes negative" mystery - no allocation bug,
199     bookkeeping bug.
200 root 1.87 - work around "player is on active list" problem by deactivating player
201     after loading.
202 root 1.81 - garbage collect shstr's more evenly and adaptively only when
203     there have in fact been allocations.
204 root 1.82 - fix object::insert to do as documented and insert into the env
205     if necessary.
206     - fix cf::map::unique_maps.
207     - fix nrof overflow check in can_merge_slow.
208     - fix converter code to handle >31 bit values.
209 elmex 1.83 - added support for the player_sold flag
210 root 1.84 - converters no longer accept unpaid items.
211 root 1.88 - canonicalize random map meta files for better unification.
212 root 1.77
213 root 1.75 2.43 Sun Apr 6 20:35:29 CEST 2008
214 root 1.72 - work around a glibc bug that causes calloc to return non-zero memory
215     when mlockall has been used.
216 root 1.71 - pass environment to perl_sys_init3, as required by newer perls.
217 root 1.72 - use separate thread for ticker timing (and more in the future).
218     this greatly increases timing accuracy and gets rid of an enourmous
219     number of gettimeofday calls.
220 root 1.82 - use a separate thread to signal aio completion, for lower latency.
221 root 1.73 - require Coro 4.47, which fixes a data corruption bug with its C API.
222 root 1.71
223 root 1.69 2.42 Sat Mar 15 12:05:21 CET 2008
224 root 1.68 - rebalanced default experience table to be more exponential
225     and much easier up to level ~40, then moderately harder.
226 root 1.67 - change attuned/repelled level boni to +-8 from +-2.
227 root 1.66 - use SvUPGRADE to avoid exception in sv_upgrade with perl 5.10.
228     - do not exit on reload/load errors but properly cleanup.
229 root 1.69 - fix a 32 bit uncleanlyness in the slice debugging wrapper.
230 root 1.66
231 root 1.64 2.41 Fri Jan 25 13:15:37 CET 2008
232 root 1.59 - get rid of YAML::Syck, it's too buggy and misparses many files
233     (this fixes the jeweler skill).
234 root 1.60 - back-to-back perl_reloads don't freeze the ticker anymore.
235 root 1.61 - convert cfutil from Event to EV (forgot to do this earlier...).
236 root 1.63 - move tombstone to real map if player died due to cave-in (even if
237     it has reset, which is better than putting it on the savebed, also as
238     proof that the palyer didn't use a savebed).
239 root 1.59
240 root 1.58 2.4 Sun Jan 13 13:41:29 CET 2008
241 root 1.56 - work around perl bug in configure perl module version check.
242 root 1.49 - fix bug in golem move code that would cause a crash at tiling borders.
243 root 1.50 - fix a freeze bug when looking for an arrow in the inventory.
244 root 1.52 - fix a bug in animate_weapon, causing a crash.
245 root 1.54 - no longer exit when a coroutine throws an exception.
246 root 1.57 - fix a potential double free bug (nicely exploited by g++ 4.2).
247 root 1.53 - fix the "<player> is nuts" message.
248 root 1.58 - fix an exception at logout due to the json_coder being gone.
249 root 1.43 - upgrade to EV version 2.0 API.
250 root 1.47 - when players don't apply a savebed correctly but stand above one,
251     do not move or kill them.
252 root 1.46 - implement client-side settings page in playerbook (0.9963+ required).
253 root 1.43 - implement generic framework for server-side resource files.
254     - implement resource file update event.
255     - hook experience table update into the framework.
256     - move jeweler.yaml to resources (arch/).
257 root 1.44 - switch from Crossfire to Deliantra perl module.
258     - implement json2json arch filter.
259 root 1.45 - implement widget protocol version 2, support for ui templates.
260 root 1.54 - mapinfo is now handled fully asynchronously.
261 root 1.48 - ext/irc: also log irc messages.
262 root 1.51 - ext/schmorplog: write user stat files asynchronously.
263 root 1.43
264 root 1.42 2.32 Sun Dec 2 18:11:01 CET 2007
265 elmex 1.41 - limited the number of items that can be picked up and dropped
266 root 1.42 as temporary measurement against bad performance or dropping things
267     (this lead to long freezes and triggered the watchdog).
268 elmex 1.41 - improved the performance of the drop command a bit.
269 root 1.38 - switch from Event to EV for higher performance, easier usage,
270     less bugs...
271 root 1.39 - updated to release version of the gnu affero license.
272 root 1.38
273 root 1.37 2.31 Sun Nov 11 17:26:28 CET 2007
274 root 1.36 - more thoroughly rename the binaries, contact addresses.
275     - update the copyrights.
276 root 1.37 - avoid backtraces due to old spells on some maps, sometimes causing
277     crashes.
278 root 1.36 - fix a problem where facedata wasn't initialised to zero properly,
279     potentially causing crashes.
280 root 1.35 - assign weapons on user load time, not login-time, avoiding
281     crashes.
282    
283 root 1.34 2.3 Sat Oct 27 11:22:38 CEST 2007
284 root 1.32 - fixed an important bug that caused passwords to be forgotten.
285 root 1.31 - implement *tag destinations for goto, slaying etc. and use it
286     in some of the maps.
287 root 1.32 - bigworldised many maps (islands as in pupland and aldwulf),
288     which is now trivial to do.
289 root 1.33 - removed all traces of the old (and never working) plug-in interface
290     (70kb code less on amd64).
291 root 1.34 - improve/tune scheduling priorities.
292     - fix some freezing bugs.
293     - fix a memory corruption problem in dynbuf.printf.
294     - use channels for chat and many informational commands.
295     - improved the tutorial.
296     - create missile is now fixed.
297     - race fields must now contain archetypes.
298     - jumping skill now works as advertised.
299 root 1.31
300 root 1.29 2.2 Tue Sep 11 15:41:24 CEST 2007
301 root 1.24 - relicense under the gnu affero license.
302 root 1.25 - new inscription skill, can only inscribe INSCRIBABLE items.
303 root 1.24 - implement server-side framework for generic resources.
304     - use resource framework for server-provided ambient
305     music.
306 root 1.27 - save object owners (players only atm).
307 root 1.24 - replace limited sound api with server-provided sound effects.
308     - new sc (sound control) protocol command.
309     - improve fxix protocol to include types.
310     - exactly fill tcp segments, if possible.
311     - output-rate is now an upper limit, the server will automatically
312     (and quite perfectly) adjust to the network conditions, ensuring
313     low latency even during bulk transfers (music, images, sounds etc.).
314     - implement server-side widgets (i.e. client widgets controlled
315     in the server side). this will allow future expansion without
316     having to upgrade clients.
317     - implement a (artwork) world map with realtime player position
318     tracking.
319     - new and more efficient extcmd (server still supports old extcmd
320     protocol).
321 root 1.26 - fixed lots of underflow/overflow bugs in diseases and general stats
322     calcluation that could be easily exploited by users.
323     - rebalanced diseases to spread more naturally/evenly.
324     - completely asynchronous map loading even for tiled maps.
325 root 1.24 - replace simple messaging protocol with channels carrying metadata
326     (similar to message types, but more directed at the user).
327     - reduce command processing latency by a whopping 120ms by
328     reordering some processing steps inside the server. this directly
329     reduces lag by 120ms.
330     - actually send spell faces to the client.
331 root 1.23 - implement player genders.
332 root 1.24 - unclean logout/login results in: nothing if map hasn't reset,
333     otherwise return to savebed and possible kill if the log-out
334     was for too long.
335     - fast socket-dead detection (kick player after 8 seconds without ack).
336     - greatly reduce the cpu time needed to draw maps _again_.
337     - archetypes are now subclasses of objects.
338     - rebalanced shop greed and approval functions to be more realistic
339     (and likely match the actual intention).
340 root 1.23 - implement "crossfire pod" format for messages, with working bold,
341     italic, gender-specific text, paragraphs etc.
342 root 1.24 - implemented hint framework, players can opt to receive hints.
343     - implemented (long) book framework, added some books from the cf wiki.
344 root 1.23 - implement generic message framework that uses xml, utf8 for the client
345     protocol and is capable of transmitting generic meta information.
346 root 1.21 - implement (in a suboptimal way) per-player instantiated maps.
347     - replace the nexus by a per-player tutorial map that teaches stuff
348     better than the newbie house.
349 root 1.18 - fix the magicmap colours.
350 root 1.19 - optimise map update even more by removing unneeded code and checks.
351     - decouple map and stats update from pl->ob and use pl->observe instead.
352     - implement observe command.
353 root 1.20 - major speed up in map refresh by replacing most get_map_from_coord
354     calls with a simple comparison.
355     - fix a latent crossfire bug that could crash the server because the
356     map refresh did not update the mapspace.
357 root 1.24 - support custom keys for regions and maps, regions are now
358     refcount-managed.
359     - allow worldmap overlays anywhere in the 000..999 range.
360     - new system to acquire time slices for background jobs, to reduce
361     jitter.
362 root 1.27 - semi-persistent object-referencing framework (currently only players
363     supported).
364 root 1.22 - dependency tracking for perl extensions.
365 root 1.24 - new slag-ex extension for cleaning cauldrons.
366     - fix invoke result processing.
367     - there are even less i/o syncpoints in the server now.
368 root 1.29 - added map-tags extension that scans all maps for object tags
369     and records them in the database (not used yet).
370 root 1.28 - metaserver 2 support.
371 root 1.22 - many more bugfixes and minor optimisations.
372 root 1.16
373 root 1.15 2.1 Sun May 27 04:21:29 CEST 2007
374 root 1.14 - optimised event invocation (non-wanted events can now be
375     skipped with 4-5 inlined instructions).
376 root 1.12 - complete rewrite of town_portal: it now creates a portal
377     to the "nearest" town only, travel is only possible
378 root 1.13 to the town and back, anybody can use it (also removes
379     one of the remaining syncpoints in the server).
380 root 1.10 - complete rewrite of the range/attack skill slot system:
381     there are now two slots, one for combat, one for ranged
382     attacks.
383     - introduce the concept of a current weapon (either a ranged
384     or a combat weapon/skill/tool) and switch between them as
385     needed.
386     - rewrite bow code so bows get more useful: apply damage,
387     attacktype and other stats to the arrows and treat
388     bows as weapons. also rebalance the missile weapons skill
389     so its damage increases with level.
390     - rewrite the complete player speed logic: weapon_speed now
391     works as documented and there are no unnatural speed boosts.
392 root 1.6 - implement a utility - cfutil - that simplifies arch and map
393     installation, replacing the old collect scripts and
394 root 1.9 simplying deployment by scaling and cutting faces as required.
395     - simplify the map protocol extensively by taking advantage
396     of missing bigfaces, speeding up map generation immensely.
397 root 1.6 - implement inherit keyword allowing archetypes to inherit from
398     other archetypes.
399     - rationalise archetype, region and treasurelist file format
400     into a single file format and make them reloadable asynchronously.
401 root 1.9 - make the worldmap, facedata (smoothing, faces, magicmap)
402     reloadable at runtime.
403 root 1.6 - implement 64x64 faceset support.
404     - implement fxixsx protocol that saves
405     a lot of bandwidth over the old image/face/smooth packets
406 root 1.11 and allows images > packetsize, incremental and background
407     transfers.
408 root 1.6 - implement a bandwidth-saving smoothing protocol that works
409     on a face basis as opposed to a mapspace basis.
410 root 1.7 - the server can now rate-limit image uploads to not exceed
411     a certain (client-configurable) speed while guarenteeing full
412     freedom of movement.
413 root 1.8 - implement new ex command to request item descriptions.
414     - implement new msg command for in-game messages with meta
415     information (using xml).
416 root 1.9 - enforce utf-8 for all text messages.
417 root 1.13 - added micropather (not used yet).
418 root 1.6 - many, many bugfixes.
419 root 1.1
420 root 1.5 2.0 Tue Mar 6 15:22:53 CET 2007
421 root 1.1 - make coroapi accessible to cf+.
422     - moved map handling logic completely to perl
423     - per player maps are now marked in the map
424 root 1.2 - maps are saved completely differently now,
425     and much more often.
426 root 1.17 - rewrote map header parser and writer, to be much faster.
427 pippijn 1.4 - maps and players are now (in the average case) loaded
428 root 1.2 and saved completely asynchronously, I/O contention will no
429     longer freeze the server.
430 pippijn 1.4 - players and maps can be loaded anytime, without the player
431 root 1.2 being logged in.
432 root 1.1 - automatically generate method interfaces for perl from headers
433     - unbundled freezethaw
434     - mostly rewrote common/map.C
435     - completely rewrite server/swap.C
436     - introduced "runtime", the CCT clock (corrected crossfire time) :)
437     - introduced new keyword for map files: file_format_version (integer, server version: 0)
438     - better message for apply failures due to applymode
439     - removed most all of the weather code
440     - unified logging to stderr and file
441     - too many minor changes to document