ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/deliantra/server/Changes
Revision: 1.449
Committed: Sat Oct 24 00:25:25 2009 UTC (14 years, 6 months ago) by root
Branch: MAIN
Changes since 1.448: +1 -0 lines
Log Message:
*** empty log message ***

File Contents

# User Rev Content
1 root 1.36 Deliantra MORPG Server, Maps and Archetypes ChangeLog.
2 root 1.220 Version numbers sort like decimal numbers.
3 root 1.6
4 root 1.443 TODO: move_on/move_off events?
5 root 1.446 TODO: create "stay invisible always" list of face names (magic_mouth.png etc.)
6 root 1.444 TODO: ->living accessors for matches!
7 root 1.436 - fixed a classical and exploitable stack buffer overflow in the gsay command.
8 root 1.429 - add @check, @find npc dialogue commands.
9     - (maps) add a number of town interiors.
10 root 1.445 - (maps) add tindervale the fireborn capitol from cfextended.
11 sf-marcmagus 1.432 - (server,arch) add a number of inscribables, show their capacity in hint.
12     - (server,maps) fix bug causing some library books not to be chained down,
13     cause Scorn/Navar libraries not to have inscribable books.
14 root 1.437 - (maps) fix bug causing the Greyshield and Greysword to have
15 sf-marcmagus 1.433 inappropriate item power.
16 root 1.448 - (maps) fix intwell balancing issue.
17 root 1.437 - improve the look of generated books.
18 sf-marcmagus 1.438 - make slag no_drop so it can't be dropped from the cauldron.
19     - fix bug where players could bypass no_drop by putting items in containers.
20 root 1.430 - consecutive commands arriving at the same time in the server would be
21     corrupted if the length was >255.
22 root 1.440 - support sub-matches in () inside match expressions, not just conditions.
23 root 1.435 - got rid of motd/rules/news code in C++ part, move motd to it's own tab
24     and perl.
25 root 1.442 - implemented new "match" type that combines both check_inv and pedestal
26     functionality (and more) inside the same object using the match expressions.
27     - create simpler match expression compiles in many common cases.
28 root 1.439 - reduce object size by removing obsolete "seen_by" member.
29 root 1.440 - removed the rather broken make_list_like utility function, taking advantage
30     of the new dynbuf::splice function (which gave an unexpected net win
31     in code size...).
32 root 1.442 - the server will no longer complain (and subtly fail) when an object
33     being removed from a map causes another object to get removed.
34 root 1.441 - banish strncpy from the server, speed up and simplify sending item
35     descriptions to the client considerably.
36 root 1.442 - add new "in head" set modifier for matches.
37     - new BLOCKED_MOVE event added.
38     - mapscript archetype now has activate_on_xxx true by default, as similar
39     connected elements.
40 root 1.448 - (maps) imported all styles from cfextended except
41 root 1.444 floorstyles/land_plots and monsterstyles.
42 root 1.448 - (arch) imported gem treasurelists and archetypes from cfextended.
43 root 1.446 - don't crash when treasure lists are empty / supply new empty
44     treasurelist for randomitems when none can be found.
45     - implement cf::map::static_maps and use it in map-tags.ext.
46 root 1.449 - fix a bug in map-tag scanning when moving tags.
47 root 1.446 - (deliantra.net) improve watchdog to now check both listening ports
48     for a reaction.
49 root 1.447 - implement new "loadall" map loading command, purely for debugging.
50 root 1.429
51 root 1.428 2.81 Mon Oct 12 20:00:18 CEST 2009
52 root 1.396 - display spell description for spellbooks, rods, wands, potion and scrolls,
53     but not horns (to make them more useful for content-creators).
54 root 1.408 - fix a number of bugs in check_move_on: 1) it didn't update the flags
55     2) it skipped spell effects and 3) it didn't handle the case where
56     and object was destroyed while iterating over it correctly. all this
57     allowed players to sometimes walk onto spaces they should not be able to
58     walk on.
59 sf-marcmagus 1.418 - fix an exploit where inscription/marking runes could execute arbitrary code.
60 root 1.399 - examining an object now dumps the serialised object form when the user
61 root 1.404 is a wizard (wizlook).
62 root 1.421 - altars no longer accept unpaid items.
63 root 1.411 - party spells didn't work all that well.
64 root 1.424 - added complex object matching framework (cf::match), and make altars
65     and pedestals use it.
66 root 1.425 - identified skill-tools show what skill they grant.
67 root 1.399 - display the duration of change_ability spells when examining them
68     (missing: protection spells, but they are a hack...).
69 sf-marcmagus 1.420 - improve effectiveness of special foods created by woodsman skill,
70     adding more variety to the different mushrooms.
71 root 1.398 - fix a minor cfpod formatting bug.
72 root 1.399 - do not talk about the hintmode so much - die-hards are expected to find
73     the hintmode setting on the settings page.
74 sf-marcmagus 1.422 - IPO no longer lies about prices; prices tweaked.
75 root 1.427 - clarified that all deliantra-specific parts are under the Affero GPL.
76 root 1.399 - enable the object loader to also dump archetypes.
77 sf-marcmagus 1.414 - (maps) fix guild teleporters to Pupland Terminal.
78 root 1.400 - (maps) put the trapdoor above the floor in sisters/necro_ruins1.
79 root 1.402 - force the initial face when loading an object that is time-animated
80     or a monster, so it does not have to be specified anymore.
81 root 1.403 - fix a bug where recasting an ability changing spell could shorten
82     its remaining duration.
83 sf-marcmagus 1.416 - fix pedestal and floor building with builder.
84 root 1.405 - fix RUNATT attack mode, which was broken before (used e.g. by mice).
85 root 1.407 - fix a broken bow-related speed optimisation by using splay - speed
86     up splay operations as well.
87 root 1.409 - use NDI_CLEAR for the body command, and make it use observe.
88 root 1.412 - implement introspection data for C++ classes (%REFLECT).
89 sf-marcmagus 1.418 - (arch) add name_pl fields and documentation for building materials.
90 root 1.415 - (maps) random fountains no longer generate permanent stat increases.
91 root 1.419 - fix transmutation alchemy.
92 root 1.424 - speed up many frequently-invoked C->perl callbacks.
93 root 1.419 - added complex object matching framework, to be used in altars and the like.
94 root 1.426 - switch to YAML::XS from YAML.
95 root 1.396
96 root 1.395 2.80 Tue Sep 15 20:22:31 CEST 2009
97 root 1.392 - fix the "screen stays black on login" bug and remove debug instrumentation
98     that ultimately was not helpful to catch it :)
99 root 1.389 - split outer_env into outer_env and outer_env_self, and fix
100     all callers to use either one or the other, as appropriate. This
101     fixes the (rather fragile) light spell, maybe others.
102     - fixed an overflow and exploit in the bank/payment code.
103     - fixed a bug in the jeweler quest and added the 'Tome of Jewelery'
104 elmex 1.384 to explain the skill a bit more.
105 root 1.389 - removed a buggy check for zero attacktype. So that we might find
106 elmex 1.388 the real bugs in the archs/maps/objects.
107 elmex 1.394 - Fixed enabling torches with lighters.
108 elmex 1.387 - (maps) Added Heaven Town region.
109     - (arch+maps) Fixed & normalized warriors on map
110     /quests/peterm/CTower/Barracks.
111 root 1.392 - fix the light spell (and possibly diseases and other lights).
112 elmex 1.388 - (arch) The clawing skill didn't have the physical attacktype.
113 root 1.392 - (maps) make the greenway accessible again - this bug was introduced
114     a long time ago, and similar cases are still to be found in the maps.
115     - make the socket_timeout configurable in the code (but not yet for users).
116 root 1.393 - earth wall health bar is now correct.
117 elmex 1.384
118 root 1.382 2.79 Tue Jul 28 00:56:36 CEST 2009
119 root 1.381 - IO::AIO chaged to using eventfd internally - updated server to not
120     freeze with IO::AIO anymore due this change.
121 root 1.364 - avoid a crash when a player tries to apply a lighter.
122 root 1.376 - allow a spell argument for dimension door.
123 root 1.362 - move shop item listing and some otherstuff into the info tab.
124 root 1.360 - avoid crashes when non-players cast party spells.
125 root 1.358 - fix a crash in get_spell_by_name (for learn_spell).
126 elmex 1.359 - added pyromancer class with graphics (by Job Vranish).
127     - small improvement of the number of potions in shops
128     (by Job Vranish).
129     - added a few party spells (by Job Vranish).
130 root 1.362 - use a common message dynbuf.
131 root 1.364 - destroying tear down objects will now use the full hp range
132     for animation and will only destroy/lastframe when hp < 0.
133     - allow monsters to use earth to dust.
134     - use manhattan distance for get_rangevector_from_mapcoord, just as
135     in get_rangevector.
136     - los updates now correctly take tiled maps into account.
137     - do los updates even on maps without darkness.
138 elmex 1.365 - fixed quiver of holding bolts to be able to hold bolts.
139 root 1.375 - upgrade to IO::AIO 3.21.
140 elmex 1.366 - fixed show invisible, to show objects of type CONTAINER.
141 elmex 1.373 - properly catching exceptions from callback in irc.ext.
142 root 1.377 - fixed a potentially hazardous bug in cfpod regarding Z<>.
143 elmex 1.370 - (maps) fixed npc dialog in /pup_land/nurnberg/reception/reception.
144 elmex 1.368 - (arch) added hint about usage to Slag Ex.
145 root 1.378 - (maps) /darcap/quest/water sea1 tile are now passable by players,
146     like the rest.
147 elmex 1.371 - (maps) added /heaven/gem_shop by Boes.
148 root 1.378 - (arch+maps) added rate limited converter and adjusted
149     /elmex/mana_fountain.
150     - store arrow->slaying in custom_name, to get rid of the spellarg slot.
151     - reduce size of casting_time, move_status, attack_movement,
152     last_heal and last_sp slots, squeezing some more space out of struct
153 root 1.379 object, also declare expmul as constant 1.0, as it isn't used
154     anywhere.
155 root 1.358
156 root 1.356 2.78 Sun Apr 5 20:04:29 CEST 2009
157     - fixed bug in alchemy, where finding the right object for enhancements
158     didn't work.
159 root 1.350 - aggressively merge spell effects and do not allow more than 5 spell
160     effects (w.r.t. put_more) per mapspace, to give the server a chance
161     to survive a hundred deathsheads.
162 root 1.346 - correctly clear op->env when inserting onto map, this was a potentially
163     disastrous bug of unfortunately unknown proportions...
164 root 1.347 - fix cone-spell symmetry that was broken for direction 8.
165 root 1.343 - use gender-neutral place descriptions for invite.
166 elmex 1.344 - (arch) new faces for alchemist class, wizard class and quetzalcoatl race.
167     Thanks go to Lisa Larsen!
168 root 1.356 - remove support for colour reducing 32x32 images (no cfclient support
169     anymore).
170 root 1.354 - actually mention the literacy level when it is too low to learn the spell.
171 root 1.345 - use better dependency tracking for include/keyword.h.
172 root 1.356 - add accept-invitation and suicide to the list of asynchronous commands,
173     so it is possible to invite somebody out of some stck-till-death traps,
174 root 1.346 or simply to commit suicide.
175 root 1.352 - replace the "ignoring delayed commands" message by something more useful
176     (cf. cunning gnome freezeing issue).
177 elmex 1.349 - various fixes for weapon improvements.
178 elmex 1.351 - fixed small bug with handling connect errors in the IRC gateway.
179 root 1.353 - support T and G sequences in cfpod.
180 root 1.343
181 root 1.341 2.77 Sun Feb 1 16:30:48 CET 2009
182 root 1.339 - convert me command from per-map to chat, which makes more sense, also
183     document it.
184 elmex 1.336 - more than one spellbooks of same class can now be given
185     in class selection.
186 elmex 1.337 - adjusted the starting_spell.trs treasure list to the recent
187     spell rebalancements.
188 elmex 1.338 - the IRC gateway filters IRC colors now.
189 elmex 1.336
190 root 1.335 2.76 Sat Jan 17 08:36:51 CET 2009
191 root 1.331 - (arch) fix quiver of Holding Bolts.
192 root 1.332 - applying unpaid items will now examine them.
193 root 1.330 - add "What" column to body command, showing items in that slot.
194 elmex 1.329 - redesigned and rebalanced lamps and torches.
195 root 1.330 - add "..." to item names that have been shortened.
196     - fixed "assign" function that squeezes strings into fixed length.
197 elmex 1.333 - add cursed effect to lamps and (some) torches.
198 elmex 1.334 - fixed bad assigned crafting skills and their tools.
199 root 1.312
200 root 1.327 2.75 Fri Jan 9 16:13:30 CET 2009
201 root 1.326 - rebalanced lighting w.r.t. outdoor, darkness and see_in_dark.
202 root 1.319 - fix a bug in the nimbus extension that allowed players to cheat.
203 root 1.312 - make monster smell logic dependent on their wisdom stat.
204 root 1.324 - put the death reason into a separate tab.
205     - converted "connected" slot to string, cleanly got rid of some ugly
206     hacks such as the path_attuned hack.
207 root 1.312 - introduce shstr_tmp for fast temporary shstr passing.
208     - replace one-at-a-time hash by faster than smaller FNV-1a hash
209     when hashing strings.
210 root 1.324 - sanitized alchemy-like skills and cauldrons to check earlier
211 elmex 1.320 whether the right cauldron is used.
212 root 1.313 - considerably optimise shared string implementation by
213 root 1.316 making its null value a compiletime constant.
214 root 1.314 - use shared string matching insteafd of strcmp in a lot of places,
215     as well as using shstr_cmp to pass shared stringsa round efficiently,
216     for lots of code size savings.
217 elmex 1.315 - monsters which breed new monsters shouldn't breed new monsters when
218     they are sleeping: generators now check for the sleeping flag.
219 root 1.318 - tell gcc not to excessively inline some perl interface functions.
220 root 1.322 - remove marking rune length limit.
221 root 1.323 - fix formatting of cfpod when a verbatim block was following
222     a single newline.
223     - move resistances, statistics and showpets command output into tabs.
224 root 1.326 - implement map scripts that can replace the boulder logic without
225     having to write extensions.
226 root 1.310
227 root 1.309 2.74 Mon Dec 29 15:23:38 CET 2008
228 root 1.302 - fix a longstanding bug that teared multipart monsters
229     at map boundaries apart.
230 root 1.292 - temporarily make permanently invisible player visible when
231     he/she makes noise.
232 root 1.284 - fix being able to see through walls a bit.
233 root 1.303 - improve look at output.
234 root 1.285 - completely replaced the line of sight algorithm with a variant
235     of spiral fov capable of visibility grades and arbitrary
236     shadow angles, that uses less memory and less code.
237     - the new los code supports arbitrary map rectangles and loosens
238 root 1.310 other restrictions of the old code, supporting further optimisations.
239     - update los if blocksview-objects are inserted in a map, not just when
240 root 1.287 removed (e.g. for summon fog).
241 root 1.303 - permanent invisibility doesn't make immune against making noise:
242     implement a noise system that allows monsters to locate the player
243     when he/she makes noise.
244     - implement a primitive smell system that monsters can use to track
245     players.
246 elmex 1.288 - create bomb now also works when casted by door traps.
247 elmex 1.290 - (arch) new torch graphics.
248 root 1.289 - (maps) considerably soften the subway spider.
249 elmex 1.295 - (maps) made the portgate of navar safe ground, to protect
250     the guards from being killed by players.
251 root 1.310 - (maps) lots of tweaks in and around scorn.
252     - (maps) use special non-blocksview jungle, mountain and
253     darkforest freely on the worldmap, to get gradual sight obstacles
254     instead of total blackout in those areas.
255 root 1.289 - no maximum darkness for outdoor maps anymore.
256 root 1.291 - add more hints, fix some messages.
257 root 1.292 - fix a bug: firing rods should tell you something about them.
258     - make light additive even within players.
259 root 1.293 - darken xrays effect a bit.
260     - improve handling of los changes when inserting or removing
261     objects, not perfect yet.
262     - make map darkness signed (formerly unsigned) to allow
263 root 1.294 ambient lighting and centrally manage darkness as an offset.
264     - revamped, fixed and documented the server calendrics, also
265     tell users the current time and data, to improve awareness.
266     - implement proper wizlook flag and handling of wizlook, instead
267     of dumbly just clearing los once.
268 root 1.296 - speed up los code - it's now about 2-3 times as fast as the old one,
269     and has a smaller runtime variance.
270 root 1.297 - daylight/nightfall can now increase/decrease past the natural limit,
271     making them actually useful.
272     - see_in_dark now increases the viewing radius by 3.
273 root 1.304 - implement a fast tiled map iterator and use it in LOS for a 20%
274     speedup, as well as in many other places.
275 root 1.299 - remove support for extended map infos - these are not used
276     by the deliantra client and removing them gives us a 10% speedup
277     when sending map changes.
278 root 1.300 - remove most gcfclient and other client bug workarounds, as well
279     as now obsolete protocol versions, simplying the code.
280 root 1.301 - optimise and simplify generation of random numbers.
281 root 1.303 - correctly provide a non-zero default density for materials, to
282     avoid crashes, fix other bugs in the material handling code.
283     - fix volume calculations.
284     - fix cfpod parsing when multiple verbatim blocks were separated by
285     newlines.
286 root 1.305 - increase monster detection radius from wis/5 to wis/3.
287 root 1.306 - remove old pickup modes.
288     - remove obsolete disarm and search commands (search wasn't working
289     anyways).
290 root 1.308 - fix a crash when an npc applied a sign.
291 root 1.284
292 root 1.282 2.73 Thu Dec 18 20:56:31 CET 2008
293 root 1.283 - this release is assumed to be very stable.
294     - (maps) radically redesigned and improved tutorial.
295 root 1.280 - directional casting no longer immediately removes the invisible effect.
296 root 1.279 - magic ears now trigger when used inside the NPC dialogue.
297 root 1.272 - fix overflow in lighting calculations.
298     - negative glow radii can no longer cause total darkness.
299 root 1.273 - allow lookat on spaces where we only barely see, as opposed to
300     only maximally-lit ones.
301 elmex 1.274 - class selection has been reworked completely and their documentation corrected.
302     - swashbucklers got the oratory skill now.
303 elmex 1.278 - jump skill was fixed to adhere to all the flags a mapspace has got.
304 elmex 1.275 - (maps) small fix w.r.t. magic ear in /scorn/houses/wizz.entry
305 root 1.276 - fix deadlock in Jeweler::improve_ring_by_plan.
306 root 1.277 - use Coro::SemaphoreSet instead of our own lock management
307     (which was probably broken, too).
308 root 1.281 - support negative glow radii during daytime, too.
309     - use circular, not rectangular, viewing area.
310     - use minimum viewing distance of 2 in outdoor maps.
311     - negative glow is stronger than viewing area or lamps.
312 root 1.283 - (arch) new darkness spell face.
313 root 1.272
314 root 1.271 2.72 Thu Dec 4 22:20:19 CET 2008
315     - (maps) completely redesigned scorn.
316 root 1.269 - "cast light" now works on oneself.
317 root 1.270 - bump max light radius to 9, rewrote glow lighting calculations, fix
318     negative glow radii again (they were totally broken before).
319 root 1.259 - the "worldmaps sometimes are black" bug is finally fixed.
320 root 1.255 - the "player objects are referenced in _GENxx globals" bug has finally
321 root 1.253 been fixed, by not relying on buggy perl internals when serialising.
322 elmex 1.257 - fixed a long standing bug in the anvil converters in armour shops.
323 elmex 1.256 - items shops weren't interested in don't vanish anymore, and are given
324     back to the player.
325 root 1.251 - attuned/repell and spell base level system reworked.
326 root 1.246 - rewrote skill cache (last_skill_ob) system and usage - might
327 root 1.247 be less erratic now.
328 root 1.248 - refuse to write the uuid file if the uuid is zero
329     (to avoid writing it in early crashes).
330 root 1.254 - pathsync the directory after saving a file for added slowdown^Wsafety.
331     - speed up emergency_save by not syncing every file separately.
332     - no longer reattach perl to every object on reload, it's slow, and no longer
333     necessary since we don't nuke stashes anymore.
334     - do not bootstrap perl from the commandline args, use separate eval for
335     better error reporting.
336 root 1.259 - fix a crash when pushing cone spells met ice attacks.
337 root 1.254 - pre-cache perl extension files on reload to speed up the reload.
338 root 1.255 - speed up map refresh in server a bit.
339 elmex 1.258 - refactored drop code and fixed some programming errors in it.
340 elmex 1.260 - fixed small regression in 'Slag Ex' potion extension.
341 elmex 1.261 - fixed a bug where some objects couldn't cross map tile boundaries.
342 elmex 1.263 - fixed a bug with weight update of the player, the client showed -0.0
343     as the current weight of the inventory.
344 elmex 1.264 - (arch) the dragonbreath spell is level 12 again, but the high level spell
345     dragonfire has been introduced for the non-dragon players.
346 root 1.265 - remove unused "tooltype", "start_holding" object slots.
347     - change "weapontype" object slot to uint8.
348     - convert "hide" object slot into flag.
349     - reorder object members for better locality of reference and codesize
350     decrease.
351 root 1.270 - correct rounding in lerp, add lerp_rd, lerp_ru.
352 root 1.267 - fix a crash when no skill could be found when killing amonster.
353 root 1.266 - fix a small memleak that would eat one pointer on the perl stack for
354     every completed aio operation.
355 root 1.270 - perl mapspace acessor methods now normalise (handle tiled maps)
356     and update mapspaces if necessary.
357 root 1.246
358 root 1.243 2.71 Tue Sep 23 07:02:23 CEST 2008
359 root 1.241 - removed all command line parsing, only env variables are supported
360     anymore.
361 root 1.239 - region-specific monsters will now once more be on the worldmap.
362 root 1.234 - fix a disastrous "memleak" where temporary memory allocations
363 root 1.225 would grow out of bounds.
364 root 1.234 - server now writes a pidfile and makes sure its alter ego is killed.
365 root 1.222 - fixed a double-escaping bug in the pod-parser.
366     - rewrote the cfpod parser in C++.
367     - hintmode moved to C++, players need to re-set their hintmode if
368     they dislike "show".
369 root 1.231 - fix RIP inscription.
370 root 1.239 - bump login name length from 18 to 20 char max.
371 root 1.231 - correctly support gender in emotes.
372     - correctly support gender in the death messages.
373     - correctly generate death messages for players only when they really die,
374     with increased information.
375 root 1.222 - fix a bug in the dynbuf code that could potentially lead to crashes
376     and data corruption (but apparently was never triggered).
377 root 1.223 - close the $ENV{LOCKUTIL_LOCK_FD} fd if in the env, for lockutil.
378 root 1.232 - make sure Compress::LZF acquires the storable lock, might fix some
379     data corruption bug.
380 root 1.223 - tweak coredumping/monitoring a bit.
381 root 1.241 - completely redid server initialisation to hopefully avoid rare races.
382 root 1.227 - do not crash in the loader when an inventory object could not be loaded
383     (from a corrupted file).
384 root 1.241 - redid skills command to send output to proper channel.
385 root 1.233 - object->map is no longer refcounting.
386 root 1.228 - add FLAG_DEBUG for internal debugging.
387 root 1.231 - add NDI_VERBATIM flag to send_msg.
388 root 1.230 - add perl backtraces to logBacktrace-initiated backtraces.
389 root 1.240 - player->exists is no longer a sync_job.
390 root 1.233 - split login.ext's player scheduler into
391     it's own player-scheduler.ext extension.
392 root 1.222
393 root 1.220 2.7 Sun Sep 7 16:32:03 CEST 2008
394 root 1.212 - require perl 5.10.
395 root 1.209 - make nrof signed, so that code that checks for underflow actually works.
396 root 1.204 - swap player and observed count's on the map when observing.
397 root 1.205 - add (mostly untested) mapspace perl class and accessors.
398 root 1.206 - re-"calibrate" value/weight autopickup to be silver/kg >= pickup*100.
399 root 1.207 - fix a crash in cast_bless (restoration et al.) when no target
400     could be found.
401 root 1.208 - pits now have a configurable "random spread" range and default
402 root 1.213 to a radius of two now.
403 root 1.212 - rewrite pay_player_arch.
404     - use a more stable perl_reload implementation.
405     - do not use Symbol::delete_package (causes crashes after perl-reload),
406     use our own, safer, clear_package instead.
407     - when asynchronously dumping core, close all file handles to allow
408     the server to restart concurrently.
409 root 1.215 - improve the cfpod parser to generate proper xml from proper cfpod
410     sequences, without double-encoding. it should be faster, too.
411     - the above fixes wrong display of help tetx and many other issues.
412 root 1.216 - use lzf and frag packets for large messages for clients supporting them
413 root 1.218 (0.9976+), use it for long books and other messages.
414 root 1.210 - eradicate listen command and corresponding code.
415 root 1.211 - eradicate logs command.
416 root 1.218 - let the client log into the server log, used for crash backtraces.
417 elmex 1.219 - fixed rods/wands/etc. with randomitem spells on maps, but broke
418     old style spell objects with the spell magic bullet.
419 root 1.220 - (arch) fixed skill less rods in the archetypes
420 root 1.204
421 root 1.203 2.61 Sun Aug 3 17:59:50 CEST 2008
422 elmex 1.197 - made jeweler workbench larger and some other minor map
423     changes in jeweler town.
424 root 1.196 - fixed wrong item handling in jeweler skill code.
425 root 1.198 - (arch) use a special "key_random_map" for random map keys
426     that are used up.
427 root 1.199 - fix a crash when the player who was observed has logged out long
428     enough for his region/map to be gone.
429 root 1.200 - port to g++-4.3's incompatible tr1 changes.
430 root 1.201 - add some missing dependencies.
431 root 1.203 - log to /var/log/deliantra/ by default.
432     - hack observe code to enable smooth movmenet when observing.
433 elmex 1.195
434 root 1.193 2.6 Sun Jul 20 18:58:08 CEST 2008
435 elmex 1.181 - (maps) extension of the jeweler quest/skill/town
436 root 1.179 - correctly move gsay to the party channel.
437 root 1.178 - fix a crash when animate weapon was used in some areas.
438 elmex 1.177 - fixed unnecessary identification of by converters created objects.
439 elmex 1.176 - (maps) tutorial now contains clues about chatting and talking
440     with NPCs.
441 elmex 1.175 - (arch) dragon scales got proper type now
442 root 1.193 - object::decrease would sometimes cause container weights to
443     be wrong, this has been fixed.
444 root 1.194 - do not send time updates for newly-seen items.
445 root 1.185 - thawing an icecube will once more drop its contents to the ground.
446 root 1.183 - fix cone spells etc. going through walls sometimes.
447 root 1.186 - fix a weight update bug that sometimes left containers
448     with wrong weights.
449 root 1.194 - added auto_apply event and extension for shop tiles.
450 root 1.172 - work around get_map_flags invoking perl and switching the stack.
451     - make sure the map is loaded when using a town portal return.
452 elmex 1.171 - fixed a bug with caching of sp/grace/food points for spells
453     where healing spells didn't cost any grace.
454 root 1.173 - fix starvation kill reason.
455 root 1.174 - fix pk killer name message.
456 root 1.189 - don't let people apply signs with @match.
457 root 1.190 - add support for berkeley db 4.7 (the new BDB module also fixes
458     what seems to be the biggets memleak in the server).
459 elmex 1.171
460 root 1.170 2.56 Wed Jun 4 10:50:40 CEST 2008
461 root 1.168 - require Coro 4.73 which contains an important performance-bugfix.
462     - use anyevent to manage listen ports (this enables IPv6 support).
463 root 1.167 - server supports ipv6 client connections now.
464 root 1.168 - use newly-available Coro::AnyEvent.
465 root 1.169 - get rid of the AnyEvent::AIO watcher, start the event thread earlier
466     to let it handle AIO requests.
467 root 1.167
468 root 1.166 2.55 Sat May 24 19:52:52 CEST 2008
469 root 1.165 - avoid newmap commands when crossing tiled map boundaries. this speeds up
470     processing considerably (especially in the client) and reduces data transfers
471     (saves roughly 1kb each crossing in typical configs). works even with gcfclient.
472 root 1.162 - (arch) fix typo in ixalovh treasurelist causing empty_archetypes to appear.
473     - (map) fixed npc dialogue in pup_land/s_f/special.
474     - bugfix: fix a crash when a player casts a swarm spell and then logs out
475     (swarm spells now stay in the player's inventory).
476 root 1.159 - bugfix: when unapplying skills also remove them from the range/combat slots.
477 root 1.162 - bugfix: do not merge items whose archetype name merges, use the
478     archetype *archname* (chairs of different facings were merged).
479     - bugfix: fix a potential crash issue in find_object_name (not used
480     normally).
481 root 1.164 - bugfix: locked doors cnanot be bashed down by magical means
482     (destruction, magic missile etc.).
483 root 1.163 - swarm spells without a direction now use various spiral patterns
484     instead of being fully random.
485 root 1.158 - update AnyEvent API to 3.4 and above.
486 root 1.156
487 root 1.155 2.54 Thu May 8 22:01:22 CEST 2008
488 root 1.146 - change floorbox item ordering to enable more efficient protocol and to
489 root 1.140 stay in sync with the 0.9971 client update which also reverses ordering.
490 root 1.152 - bugfix: the jumping skill now gives experience for jumping
491     and for attacking monsters. it also takes about one second to do a jump.
492 root 1.138 - bugfix: players couldn't starve in 2.53 :(
493 root 1.136 - bugfix: correctly send the client a del_spell when a spell gets removed.
494 root 1.152 - bugfix: spell effects like word of recall are removed on death.
495 root 1.141 - bugfix: fix a crash when objects with treasure on top (ground...)
496     were created outside a map.
497 root 1.145 - bugfix: couldn't apply inventory items when levitating, but ground items
498     (fixed by reversing the logic).
499 root 1.152 - bugfix: fixed a mismatched '"' in the debugging description of objects
500 root 1.153 - bugfix: the random map generator no longer leaks key objects.
501 root 1.154 - bugfix: support random maps >127x127.
502 root 1.152 - (maps) fixed the death certificate system in nimbus.
503 root 1.159 - (maps) rebalance onefang, build a road to onefang, temporarily closed zorn.
504 root 1.152 - (arch) the material 'wood' was undefined, it's now a burnable material.
505 root 1.147 - (arch) give ball lightning a real name.
506 root 1.152 - (arch) fixed material of bones (was 'wood', is now 'bone')
507 root 1.155 - support cfpod in ex replies (client item tooltips).
508 root 1.143 - unapply item in range slow when readying a spell.
509 root 1.148 - bugfix: account for rounding errors in weight updates.
510 root 1.139 - remove synchronous mkdir in chargen_race_done.
511     - fix per-race starting maps.
512 root 1.142 - check hiscore on suicide and quit as well.
513 root 1.138 - tell players when they are starving.
514 root 1.133 - get rid of costly object_from_name conversion for altar effects.
515     - fix map difficulty calculation for generators.
516 root 1.146 - slightly more intelligent handling of "is_animated" flag.
517 root 1.149 - support no_drop map header flag (before it was only available internally).
518 root 1.153 - make random-map-generated keys crumble after one hour, use more unique slaying.
519 root 1.133
520 root 1.130 2.53 Sun May 4 17:32:48 CEST 2008
521 root 1.119 - bugfix: custom skill settings were not saved by the server.
522     - bugfix: remove did not actually remove items from the inventory, leaving
523 root 1.116 ghost items.
524 root 1.119 - bugfix: properly update items identified on the ground.
525 root 1.120 - bugfix: use localtime_r in the logger thread.
526 root 1.122 - bugfix: player starvation will now give the correct kill reason.
527     - bugfix: archetype reloads could crash the server.
528 root 1.119 - bugfix: the mailscrolls are now correctly handed out even when the destination
529 elmex 1.114 player is not logged in.
530 root 1.119 - bugfix: make list_logins non-blocking (glaring oversight). this caused the lag at
531 root 1.117 server startup.
532 root 1.128 - bugfix: fix the door surround check in the random map generator.
533     - (maps) fix heaven quest difficulty progression.
534     - (maps) fix some random map styles.
535     - dropping items a shop is not interested in won't sell them anymore.
536     - rods and horns with a too low maximum charge allow now at least one discharge.
537     - implement kill & death statistics.
538     - random map preparation is no longer synchronous.
539     - rewrite find_style in perl, no longer does synchronous I/O.
540     - improve random map specials placement.
541     - make the killer a real object pointer instead of a string, improved
542     kill reason messages.
543 root 1.117 - take advantage of new aio_close and aio_chmod.
544 root 1.128 - implement archetype::get, object::deep_clone and update callers.
545 root 1.125 - change_abil is much faster.
546 root 1.126 - update the floorbox more often to work around the reverses item order
547     display in clients.
548 root 1.125 - cleaned up object copying by encapsulating it to a single place.
549 root 1.126 - add hints to the invite messages.
550 root 1.127 - rewrote key<->value pair handling.
551 root 1.128 - use an independent random number generator for the random map generator.
552 elmex 1.113
553 root 1.112 2.52 Thu Apr 24 11:47:19 CEST 2008
554 root 1.106 - completely automate the item add/delete on remove/insert. this should fix
555     all "ghost" item bugs caused by sloppy coding, as sloppy coding is now correct :)
556     - completely automate the weight handling, should fix all weight
557     accounting bugs caused by sloppy coding, as sloppy coding is now correct :)
558 root 1.103 - reloading archetypes while a user was in the character creation phase
559     could crash the server.
560 root 1.106 - fix a nontrivial number of cases of code commented similar
561     to "is this really correct?", as many of those cases are now handles
562     automatically by lower level code.
563     - replace many ad-hoc checks for client visibility by object::visible_to,
564     should result in broader applicability of functions using it.
565 root 1.104 - merge items with different arch pointers refering to the same arch
566     (due to archetype reloads).
567 root 1.106 - refactored the object remove/insert functions and most related
568     functions (decrease, split, merge_ob etc.).
569 root 1.105 - make it compile better on freebsd (reported by pippijn).
570 root 1.106 - remove GT_UPDATE_INV (no longer applicable).
571 root 1.108 - fix the longstanding "container stays open" bug.
572 root 1.107 - improved floorbox updating to be incremental and other protocol
573     optimisations.
574     - get rid of update_after_inventory_change and only do update stats
575     for weight once/tick/player at max.
576 root 1.109 - rewrite party commands, use party channel.
577 root 1.103
578 root 1.102 2.51 Sun Apr 20 21:27:37 CEST 2008
579 root 1.97 - properly link against libgthread as that is needed to make the slice
580     allocator thread-safe.
581 root 1.91 - support perls not compiled with 64 bit support (though this is not a
582     recommended configuration) (reported by Samuel Gondouin).
583 root 1.94 - always put godgiven items into the player inventory, never any containers.
584 root 1.92 - (maps, arch) the scorn go club was founded!
585 root 1.93 - (arch) do no longer support player abilities, they didn't work anyways.
586 root 1.100 - (arch) the alchemy spell is now of the alchemy spell school, which
587     became a real spell-class.
588 root 1.102 - (arch) the alchemist class now get an alchemy spell book for new characters.
589     - (arch) considerably strengthened spark shower and destruction.
590     - match archetypes by name, not by ptr, in treasure.C, this makes archetypes
591     finally reloadable at runtime.
592     - changed archetype loading algorithm to only require one pass and
593     use delayed resolving of references.
594 root 1.101 - examine command now uses the examine infobox.
595 root 1.102 - implement an "incremental garbage collector" for archetypes.
596 root 1.98 - enable slice allocator again.
597 root 1.96 - implement optional free memory poisoning.
598 root 1.91
599 root 1.89 2.5 Wed Apr 16 15:06:53 CEST 2008
600 root 1.90 - the two handed weapon skill can no longer be used as unarmed combat
601 root 1.85 skill.
602 root 1.84 - append [drop xxx coins] to altar/trigger_altar/identify_table/converter
603     names (also update all maps to use money instead of coins).
604 root 1.78 - add uuid accessors to perl.
605     - add coin names and archetype accessors to perl.
606 root 1.80 - fix runtime uuid file format to use "." instead of ",".
607 root 1.78 - change perl extensions to not use hardcoded coins and values.
608 root 1.79 - write uuids asynchronously (no hiccups due to uuid writes)
609     and be more parsimonous of uuid usage by the exact value out on exit.
610 root 1.86 - write log messages in another thread, removing another sync point.
611     - support multi-line log messages in a nicer way.
612 root 1.80 - be more portable w.r.t. uuids and format specifiers everywhere.
613 root 1.81 - fix a minor memleak in the random map generator.
614     - some parts of the random map generator are not coroutine-safe,
615     so only call it "single-threaded".
616     - major cleanup of memory management in random map generator.
617 root 1.87 - slight refactoring of the random map generator, faster too.
618 root 1.81 - solve the "slice_alloc becomes negative" mystery - no allocation bug,
619     bookkeeping bug.
620 root 1.87 - work around "player is on active list" problem by deactivating player
621     after loading.
622 root 1.81 - garbage collect shstr's more evenly and adaptively only when
623     there have in fact been allocations.
624 root 1.82 - fix object::insert to do as documented and insert into the env
625     if necessary.
626     - fix cf::map::unique_maps.
627     - fix nrof overflow check in can_merge_slow.
628     - fix converter code to handle >31 bit values.
629 elmex 1.83 - added support for the player_sold flag
630 root 1.84 - converters no longer accept unpaid items.
631 root 1.88 - canonicalize random map meta files for better unification.
632 root 1.77
633 root 1.75 2.43 Sun Apr 6 20:35:29 CEST 2008
634 root 1.72 - work around a glibc bug that causes calloc to return non-zero memory
635     when mlockall has been used.
636 root 1.71 - pass environment to perl_sys_init3, as required by newer perls.
637 root 1.72 - use separate thread for ticker timing (and more in the future).
638     this greatly increases timing accuracy and gets rid of an enourmous
639     number of gettimeofday calls.
640 root 1.82 - use a separate thread to signal aio completion, for lower latency.
641 root 1.73 - require Coro 4.47, which fixes a data corruption bug with its C API.
642 root 1.71
643 root 1.69 2.42 Sat Mar 15 12:05:21 CET 2008
644 root 1.68 - rebalanced default experience table to be more exponential
645     and much easier up to level ~40, then moderately harder.
646 root 1.67 - change attuned/repelled level boni to +-8 from +-2.
647 root 1.66 - use SvUPGRADE to avoid exception in sv_upgrade with perl 5.10.
648     - do not exit on reload/load errors but properly cleanup.
649 root 1.69 - fix a 32 bit uncleanlyness in the slice debugging wrapper.
650 root 1.66
651 root 1.64 2.41 Fri Jan 25 13:15:37 CET 2008
652 root 1.59 - get rid of YAML::Syck, it's too buggy and misparses many files
653     (this fixes the jeweler skill).
654 root 1.60 - back-to-back perl_reloads don't freeze the ticker anymore.
655 root 1.61 - convert cfutil from Event to EV (forgot to do this earlier...).
656 root 1.63 - move tombstone to real map if player died due to cave-in (even if
657     it has reset, which is better than putting it on the savebed, also as
658 root 1.321 proof that the player didn't use a savebed).
659 root 1.59
660 root 1.58 2.4 Sun Jan 13 13:41:29 CET 2008
661 root 1.56 - work around perl bug in configure perl module version check.
662 root 1.49 - fix bug in golem move code that would cause a crash at tiling borders.
663 root 1.50 - fix a freeze bug when looking for an arrow in the inventory.
664 root 1.52 - fix a bug in animate_weapon, causing a crash.
665 root 1.54 - no longer exit when a coroutine throws an exception.
666 root 1.57 - fix a potential double free bug (nicely exploited by g++ 4.2).
667 root 1.53 - fix the "<player> is nuts" message.
668 root 1.58 - fix an exception at logout due to the json_coder being gone.
669 root 1.43 - upgrade to EV version 2.0 API.
670 root 1.47 - when players don't apply a savebed correctly but stand above one,
671     do not move or kill them.
672 root 1.46 - implement client-side settings page in playerbook (0.9963+ required).
673 root 1.43 - implement generic framework for server-side resource files.
674     - implement resource file update event.
675     - hook experience table update into the framework.
676     - move jeweler.yaml to resources (arch/).
677 root 1.44 - switch from Crossfire to Deliantra perl module.
678     - implement json2json arch filter.
679 root 1.45 - implement widget protocol version 2, support for ui templates.
680 root 1.54 - mapinfo is now handled fully asynchronously.
681 root 1.48 - ext/irc: also log irc messages.
682 root 1.51 - ext/schmorplog: write user stat files asynchronously.
683 root 1.43
684 root 1.42 2.32 Sun Dec 2 18:11:01 CET 2007
685 elmex 1.41 - limited the number of items that can be picked up and dropped
686 root 1.42 as temporary measurement against bad performance or dropping things
687     (this lead to long freezes and triggered the watchdog).
688 elmex 1.41 - improved the performance of the drop command a bit.
689 root 1.38 - switch from Event to EV for higher performance, easier usage,
690     less bugs...
691 root 1.39 - updated to release version of the gnu affero license.
692 root 1.38
693 root 1.37 2.31 Sun Nov 11 17:26:28 CET 2007
694 root 1.36 - more thoroughly rename the binaries, contact addresses.
695     - update the copyrights.
696 root 1.37 - avoid backtraces due to old spells on some maps, sometimes causing
697     crashes.
698 root 1.36 - fix a problem where facedata wasn't initialised to zero properly,
699     potentially causing crashes.
700 root 1.35 - assign weapons on user load time, not login-time, avoiding
701     crashes.
702    
703 root 1.34 2.3 Sat Oct 27 11:22:38 CEST 2007
704 root 1.32 - fixed an important bug that caused passwords to be forgotten.
705 root 1.31 - implement *tag destinations for goto, slaying etc. and use it
706     in some of the maps.
707 root 1.32 - bigworldised many maps (islands as in pupland and aldwulf),
708     which is now trivial to do.
709 root 1.33 - removed all traces of the old (and never working) plug-in interface
710     (70kb code less on amd64).
711 root 1.34 - improve/tune scheduling priorities.
712     - fix some freezing bugs.
713     - fix a memory corruption problem in dynbuf.printf.
714     - use channels for chat and many informational commands.
715     - improved the tutorial.
716     - create missile is now fixed.
717     - race fields must now contain archetypes.
718     - jumping skill now works as advertised.
719 root 1.31
720 root 1.29 2.2 Tue Sep 11 15:41:24 CEST 2007
721 root 1.24 - relicense under the gnu affero license.
722 root 1.25 - new inscription skill, can only inscribe INSCRIBABLE items.
723 root 1.24 - implement server-side framework for generic resources.
724     - use resource framework for server-provided ambient
725     music.
726 root 1.27 - save object owners (players only atm).
727 root 1.24 - replace limited sound api with server-provided sound effects.
728     - new sc (sound control) protocol command.
729     - improve fxix protocol to include types.
730     - exactly fill tcp segments, if possible.
731     - output-rate is now an upper limit, the server will automatically
732     (and quite perfectly) adjust to the network conditions, ensuring
733     low latency even during bulk transfers (music, images, sounds etc.).
734     - implement server-side widgets (i.e. client widgets controlled
735     in the server side). this will allow future expansion without
736     having to upgrade clients.
737     - implement a (artwork) world map with realtime player position
738     tracking.
739     - new and more efficient extcmd (server still supports old extcmd
740     protocol).
741 root 1.26 - fixed lots of underflow/overflow bugs in diseases and general stats
742     calcluation that could be easily exploited by users.
743     - rebalanced diseases to spread more naturally/evenly.
744     - completely asynchronous map loading even for tiled maps.
745 root 1.24 - replace simple messaging protocol with channels carrying metadata
746     (similar to message types, but more directed at the user).
747     - reduce command processing latency by a whopping 120ms by
748     reordering some processing steps inside the server. this directly
749     reduces lag by 120ms.
750     - actually send spell faces to the client.
751 root 1.23 - implement player genders.
752 root 1.24 - unclean logout/login results in: nothing if map hasn't reset,
753     otherwise return to savebed and possible kill if the log-out
754     was for too long.
755     - fast socket-dead detection (kick player after 8 seconds without ack).
756     - greatly reduce the cpu time needed to draw maps _again_.
757     - archetypes are now subclasses of objects.
758     - rebalanced shop greed and approval functions to be more realistic
759     (and likely match the actual intention).
760 root 1.23 - implement "crossfire pod" format for messages, with working bold,
761     italic, gender-specific text, paragraphs etc.
762 root 1.24 - implemented hint framework, players can opt to receive hints.
763     - implemented (long) book framework, added some books from the cf wiki.
764 root 1.23 - implement generic message framework that uses xml, utf8 for the client
765     protocol and is capable of transmitting generic meta information.
766 root 1.21 - implement (in a suboptimal way) per-player instantiated maps.
767     - replace the nexus by a per-player tutorial map that teaches stuff
768     better than the newbie house.
769 root 1.18 - fix the magicmap colours.
770 root 1.19 - optimise map update even more by removing unneeded code and checks.
771     - decouple map and stats update from pl->ob and use pl->observe instead.
772     - implement observe command.
773 root 1.20 - major speed up in map refresh by replacing most get_map_from_coord
774     calls with a simple comparison.
775     - fix a latent crossfire bug that could crash the server because the
776     map refresh did not update the mapspace.
777 root 1.24 - support custom keys for regions and maps, regions are now
778     refcount-managed.
779     - allow worldmap overlays anywhere in the 000..999 range.
780     - new system to acquire time slices for background jobs, to reduce
781     jitter.
782 root 1.27 - semi-persistent object-referencing framework (currently only players
783     supported).
784 root 1.22 - dependency tracking for perl extensions.
785 root 1.24 - new slag-ex extension for cleaning cauldrons.
786     - fix invoke result processing.
787     - there are even less i/o syncpoints in the server now.
788 root 1.29 - added map-tags extension that scans all maps for object tags
789     and records them in the database (not used yet).
790 root 1.28 - metaserver 2 support.
791 root 1.22 - many more bugfixes and minor optimisations.
792 root 1.16
793 root 1.15 2.1 Sun May 27 04:21:29 CEST 2007
794 root 1.14 - optimised event invocation (non-wanted events can now be
795     skipped with 4-5 inlined instructions).
796 root 1.12 - complete rewrite of town_portal: it now creates a portal
797     to the "nearest" town only, travel is only possible
798 root 1.13 to the town and back, anybody can use it (also removes
799     one of the remaining syncpoints in the server).
800 root 1.10 - complete rewrite of the range/attack skill slot system:
801     there are now two slots, one for combat, one for ranged
802     attacks.
803     - introduce the concept of a current weapon (either a ranged
804     or a combat weapon/skill/tool) and switch between them as
805     needed.
806     - rewrite bow code so bows get more useful: apply damage,
807     attacktype and other stats to the arrows and treat
808     bows as weapons. also rebalance the missile weapons skill
809     so its damage increases with level.
810     - rewrite the complete player speed logic: weapon_speed now
811     works as documented and there are no unnatural speed boosts.
812 root 1.6 - implement a utility - cfutil - that simplifies arch and map
813     installation, replacing the old collect scripts and
814 root 1.9 simplying deployment by scaling and cutting faces as required.
815     - simplify the map protocol extensively by taking advantage
816     of missing bigfaces, speeding up map generation immensely.
817 root 1.6 - implement inherit keyword allowing archetypes to inherit from
818     other archetypes.
819     - rationalise archetype, region and treasurelist file format
820     into a single file format and make them reloadable asynchronously.
821 root 1.9 - make the worldmap, facedata (smoothing, faces, magicmap)
822     reloadable at runtime.
823 root 1.6 - implement 64x64 faceset support.
824     - implement fxixsx protocol that saves
825     a lot of bandwidth over the old image/face/smooth packets
826 root 1.11 and allows images > packetsize, incremental and background
827     transfers.
828 root 1.6 - implement a bandwidth-saving smoothing protocol that works
829     on a face basis as opposed to a mapspace basis.
830 root 1.7 - the server can now rate-limit image uploads to not exceed
831     a certain (client-configurable) speed while guarenteeing full
832     freedom of movement.
833 root 1.8 - implement new ex command to request item descriptions.
834     - implement new msg command for in-game messages with meta
835     information (using xml).
836 root 1.9 - enforce utf-8 for all text messages.
837 root 1.13 - added micropather (not used yet).
838 root 1.6 - many, many bugfixes.
839 root 1.1
840 root 1.5 2.0 Tue Mar 6 15:22:53 CET 2007
841 root 1.1 - make coroapi accessible to cf+.
842     - moved map handling logic completely to perl
843     - per player maps are now marked in the map
844 root 1.2 - maps are saved completely differently now,
845     and much more often.
846 root 1.17 - rewrote map header parser and writer, to be much faster.
847 pippijn 1.4 - maps and players are now (in the average case) loaded
848 root 1.2 and saved completely asynchronously, I/O contention will no
849     longer freeze the server.
850 pippijn 1.4 - players and maps can be loaded anytime, without the player
851 root 1.2 being logged in.
852 root 1.1 - automatically generate method interfaces for perl from headers
853     - unbundled freezethaw
854     - mostly rewrote common/map.C
855     - completely rewrite server/swap.C
856     - introduced "runtime", the CCT clock (corrected crossfire time) :)
857     - introduced new keyword for map files: file_format_version (integer, server version: 0)
858     - better message for apply failures due to applymode
859     - removed most all of the weather code
860     - unified logging to stderr and file
861     - too many minor changes to document