Xlogfile - Revision history

Actual-nh: /* File format */ Grammar/style

2021-06-16T18:23:36Z

‎File format: Grammar/style

Actual-nh: /* File format */ Grammar/style; noted effects of having in text form

2021-06-16T18:22:07Z

‎File format: Grammar/style; noted effects of having in text form

Phol ende wodan: Tab is not "some variants"; it is the vanilla default. Only users of the original patch will see colons. Additionally, conductX and achieveX are vanilla xlog fields in 3.7 and are not original to variants.

2021-06-14T19:12:23Z

Tab is not "some variants"; it is the vanilla default. Only users of the original patch will see colons. Additionally, conductX and achieveX are vanilla xlog fields in 3.7 and are not original to variants.

Actual-nh: /* File format */ Added conduct links

2021-06-14T18:05:47Z

‎File format: Added conduct links

Actual-nh: /* File format */ xNetHack uses tabs as separators, not colons

2021-06-14T17:51:58Z

‎File format: xNetHack uses tabs as separators, not colons

Actual-nh: Grammar/style

2021-06-14T17:39:12Z

Grammar/style

Actual-nh: /* File format */ Capitalization

2021-06-14T17:35:59Z

‎File format: Capitalization

Aximili: Split into sections, add category

2020-02-23T00:42:31Z

Split into sections, add category

Tomsod: 3.6 new conducts

2018-12-02T13:04:23Z

3.6 new conducts

192.249.60.111: Add reference section

2016-03-10T03:37:19Z

Add reference section

@@ Line 59: / Line 59: @@
 **0x4: Never loaded a [[Bones]] file
-{{upcoming|NetHack 3.7.0|The <code>conductX</code> and <code>achieveX</code> fields are added that encode conducts and game achievements in text form, allowing for easier addition of new conducts and achievements and making the file easier to read by humans.}}
+{{upcoming|NetHack 3.7.0|The fields <code>conductX</code> and <code>achieveX</code> are added that encode conducts and game achievements in text form, allowing for easier addition of new conducts and achievements and making the file easier to read by humans.}}
 ==References==

@@ Line 59: / Line 59: @@
 **0x4: Never loaded a [[Bones]] file
-{{upcoming|NetHack 3.7.0|conductX and achieveX fields are added that encode the conduct and game achievements in text form rather than bitmasks.}}
+{{upcoming|NetHack 3.7.0|The <code>conductX</code> and <code>achieveX</code> fields are added that encode conducts and game achievements in text form, allowing for easier addition of new conducts and achievements and making the file easier to read by humans.}}
 ==References==

@@ Line 8: / Line 8: @@
 }}
-'''xlogfile''', or the extended [[logfile]], is a [[compile-time option]] for NetHack that makes the game log more data at the end of a game.
+'''xlogfile''', or the extended [[logfile]], is a [[compile-time option]] for NetHack that makes the game log more data at the end of a game than is stored by default in the regular [[logfile]]
-The xlogfile began as a [[patch]] for [[NetHack 3.4.3]]. It was incorporated into the mainline in [[NetHack 3.6.0]]. It is an optional feature, and can be removed by commenting out the definition of XLOGFILE in include/config.h.
+The xlogfile began as a [[patch]] for [[NetHack 3.4.3]]. It was incorporated into the mainline in [[NetHack 3.6.0]]. It is an optional feature, enabled by default, and can be removed by commenting out the definition of XLOGFILE in include/config.h.
 == File format ==
-The data is saved into a file named <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, separated by a colon (or a tab in some variants, which may also add extensions such as <code>conductX</code> and <code>achieveX</code> with text-format conducts and achievements). For example:
+The data is saved into a file named <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, delimited by tabs. For example:
-  version=3.4.3:points=55590:deathdnum=0:deathlev=7:maxlvl=12:hp=-14:maxhp=92:deaths=1:deathdate=20090502:birthdate=20090501:uid=5:role=Tou:race=Hum:gender=Fem:align=Neu:name=gibbas:death=killed by a mumak:conduct=0xf86:turns=16662:achieve=0x400:realtime=18452:starttime=1241195443:endtime=1241214565:gender0=Fem:align0=Neu
+  version=3.6.3	points=972	deathdnum=0	deathlev=4	maxlvl=5	hp=0	maxhp=48	deaths=1	deathdate=20191206	birthdate=20191206	uid=5	role=Val	race=Hum	gender=Fem	align=Law	name=merpish	death=killed by a water elemental	conduct=0xf80	turns=3711	achieve=0x0	realtime=708	starttime=1575647272	endtime=1575647980	gender0=Fem	align0=Law	flags=0x4
 Most of the fields are self-explanatory, or are the same as in the normal [[logfile]]. Exceptions are:
@@ Line 56: / Line 58: @@
 **0x2: [[Discover mode]]
 **0x4: Never loaded a [[Bones]] file
 ==References==
@@ Line 62: / Line 66: @@
 [[Category:Annotations]]
 [[Category:Patches]]
-{{nethack-360}}
+{{nethack-366}}

@@ Line 19: / Line 19: @@
 Most of the fields are self-explanatory, or are the same as in the normal [[logfile]]. Exceptions are:
-*conduct: A bitfield in hexadecimal format:
+*[[conduct]]: A bitfield in hexadecimal format:
-**0x001: Foodless
+**0x001: [[Foodless]]
 **0x002: Vegan
 **0x004: Vegetarian
-**0x008: Atheist
+**0x008: [[Atheist]]
-**0x010: Weaponless
+**0x010: [[Never hit with a wielded weapon|Weaponless]]
-**0x020: Pacifist
+**0x020: [[Pacifist]]
-**0x040: Illiterate
+**0x040: [[Illiterate]]
 **0x080: Polypileless
 **0x100: Polyselfless
-**0x200: Wishless
+**0x200: [[Wishless]]
 **0x400: Artifact wishless
 **0x800: Genocideless

@@ Line 14: / Line 14: @@
 == File format ==
-The data is saved into a file named <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, separated by a colon. For example:
+The data is saved into a file named <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, separated by a colon (or a tab in some variants, which may also add extensions such as <code>conductX</code> and <code>achieveX</code> with text-format conducts and achievements). For example:
   version=3.4.3:points=55590:deathdnum=0:deathlev=7:maxlvl=12:hp=-14:maxhp=92:deaths=1:deathdate=20090502:birthdate=20090501:uid=5:role=Tou:race=Hum:gender=Fem:align=Neu:name=gibbas:death=killed by a mumak:conduct=0xf86:turns=16662:achieve=0x400:realtime=18452:starttime=1241195443:endtime=1241214565:gender0=Fem:align0=Neu

@@ Line 14: / Line 14: @@
 == File format ==
-The data is saved into a file <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, separated by a colon. For example:
+The data is saved into a file named <code>xlogfile</code> in the same directory as the normal logfile. Each line contains several <tt>field=value</tt> pairs, separated by a colon. For example:
   version=3.4.3:points=55590:deathdnum=0:deathlev=7:maxlvl=12:hp=-14:maxhp=92:deaths=1:deathdate=20090502:birthdate=20090501:uid=5:role=Tou:race=Hum:gender=Fem:align=Neu:name=gibbas:death=killed by a mumak:conduct=0xf86:turns=16662:achieve=0x400:realtime=18452:starttime=1241195443:endtime=1241214565:gender0=Fem:align0=Neu
-Most of the fields are self-explanatory, or are the same as in the normal logfile. Exceptions:
+Most of the fields are self-explanatory, or are the same as in the normal [[logfile]]. Exceptions are:
 *conduct: A bitfield in hexadecimal format:
@@ Line 39: / Line 39: @@
 **0x0010: Performed the [[Invocation]]
 **0x0020: Got the [[Amulet of Yendor]]
-**0x0040: Was in Endgame
+**0x0040: Was in the [[End Game]]
 **0x0080: Was on the [[Astral Plane]]
 **0x0100: Ascended
@@ Line 51: / Line 51: @@
 *gender0: The original (starting) [[gender]].
 *align0: The original (starting) [[alignment]].
-*death: all colons are replaced with underscores, otherwise the same as in normal logfile.
+*death: All colons are replaced with underscores, otherwise the same as in the normal logfile.
 *flags: A bitfield in hexadecimal format:{{reffunc|topten.c|encodexlogflags}}
 **0x1: [[Wizard mode]]

@@ Line 29: / Line 29: @@
 **0x800: Genocideless
 *achieve: A bitfield in hexadecimal format:
-**0x001: Got the [[Bell of Opening]]
+**0x0001: Got the [[Bell of Opening]]
-**0x002: Entered [[Gehennom]]
+**0x0002: Entered [[Gehennom]]
-**0x004: Got the [[Candelabrum of Invocation]]
+**0x0004: Got the [[Candelabrum of Invocation]]
-**0x008: Got the [[Book of the Dead]]
+**0x0008: Got the [[Book of the Dead]]
-**0x010: Performed the [[Invocation]]
+**0x0010: Performed the [[Invocation]]
-**0x020: Got the [[Amulet of Yendor]]
+**0x0020: Got the [[Amulet of Yendor]]
-**0x040: Was in Endgame
+**0x0040: Was in Endgame
-**0x080: Was on The [[Astral Plane]]
+**0x0080: Was on The [[Astral Plane]]
-**0x100: Ascended
+**0x0100: Ascended
-**0x200: Got the [[Luckstone]] at the [[Mine's End]]
+**0x0200: Got the [[Luckstone]] at the [[Mine's End]]
-**0x400: Finished [[Sokoban]]
+**0x0400: Finished [[Sokoban]]
-**0x800: Killed [[Medusa]]
+**0x0800: Killed [[Medusa]]
 *realtime: How long the game was, in seconds.
 *starttime and endtime: Seconds since [[wikipedia:UNIX Epoch|UNIX Epoch]].