Curses interface - Revision history

Umbire the Phantom: formatting + copyedit pass

2024-06-21T09:44:27Z

formatting + copyedit pass

Furey: ZapM -> ZAPM. In this case I want the article to use the correct capitalization, not have a redirect. Fixes one redlink.

2024-06-18T17:35:00Z

ZapM -> ZAPM. In this case I want the article to use the correct capitalization, not have a redirect. Fixes one redlink.

Noisytoot: Add missing `tags and clarify that nh4 and variants use libuncursed, not curses`

2024-05-22T15:27:06Z Add missing <tt> tags and clarify that nh4 and variants use libuncursed, not curses ← Older revision Revision as of 15:27, 22 May 2024 Line 23: Line 23: [[Hardfought]] offers the curses interface for almost every variant hosted, save for [[NetHack 1.3d]], [[Slash'EM]], [[SlashTHEM]] and [[ZapM]]. [[Hardfought]] offers the curses interface for almost every variant hosted, save for [[NetHack 1.3d]], [[Slash'EM]], [[SlashTHEM]] and [[ZapM]]. − [[NetHack 4]] and its derivatives [[NetHack Fourk]] and [[FIQHack]], as well as [[DynaHack]] use the curses interface by default; any server which hosts these variants supports it. + [[DynaHack]] uses the curses interface by default. + + [[NetHack 4]] and its derivatives [[NetHack Fourk]] and [[FIQHack]] use an interface similar to curses but do not actually use curses, instead using libuncursed. ==Configuration options== ==Configuration options== Line 33: Line 35: |'''Use this to enable curses interface''', if the binary was compiled with multiple window interfaces, and curses is not the default. |'''Use this to enable curses interface''', if the binary was compiled with multiple window interfaces, and curses is not the default. |- |- − |OPTIONS=symset:IBMgraphics</tt> + |<tt>OPTIONS=symset:IBMgraphics</tt> |Set this for Windows systems, or for PDCurses for SDL on any system. The latter uses a cp437 font, which works with this option. For 3.4.3, use <tt>OPTIONS=IBMgraphics</tt>. |Set this for Windows systems, or for PDCurses for SDL on any system. The latter uses a cp437 font, which works with this option. For 3.4.3, use <tt>OPTIONS=IBMgraphics</tt>. |- |- − |OPTIONS=symset:curses</tt> + |<tt>OPTIONS=symset:curses</tt> |Set this if IBMgraphics above won't work for your system. Mutually exclusive with the above option, and should work on nearly any system. For 3.4.3, use <tt>OPTIONS=cursesgraphics</tt>. |Set this if IBMgraphics above won't work for your system. Mutually exclusive with the above option, and should work on nearly any system. For 3.4.3, use <tt>OPTIONS=cursesgraphics</tt>. |- |-

Furey: /* History */ 3.4.3 options. 2024-05-22T15:17:41Z ‎History: 3.4.3 options. ← Older revision Revision as of 15:17, 22 May 2024 Line 78: Line 78: Karl Garrison developed the curses interface as a patch for NetHack 3.4.3. Both NAO and hardfought incorporated the curses interface patch in their servers. In NetHack 3.6.2, the devteam incorporated the curses interface into the vanilla codebase. Karl Garrison developed the curses interface as a patch for NetHack 3.4.3. Both NAO and hardfought incorporated the curses interface patch in their servers. In NetHack 3.6.2, the devteam incorporated the curses interface into the vanilla codebase. + + ===3.4.3 Options=== + + <tt>OPTIONS=classic_status</tt> is a boolean option. If FALSE, the status bar has 3 lines. If TRUE, the status display has 2 lines. The default value is TRUE. + + ===Historical Links=== The following links are of historical value only. The following links are of historical value only. Furey: /* Features */ cursesgraphics -> symset:curses. "cursesgraphics" was 3.4.3, "symset:curses" is 3.6.7. 2024-05-22T14:57:00Z ‎Features: cursesgraphics -> symset:curses. "cursesgraphics" was 3.4.3, "symset:curses" is 3.6.7. ← Older revision Revision as of 14:57, 22 May 2024 Line 15: Line 15: * Fancier display (e.g. window borders, optional popup dialogs, splash screen, and better menus) * Fancier display (e.g. window borders, optional popup dialogs, splash screen, and better menus) * Improved keyboard navigation of menus * Improved keyboard navigation of menus − * "cursesgraphics" option for fancier line-drawing characters for drawing the dungeon—this should work on most terminals and platforms + * "symset:curses" option for fancier line-drawing characters for drawing the dungeon—this should work on most terminals and platforms * Ability to have a permanent inventory sidebar by enabling <tt>perm_invent</tt> * Ability to have a permanent inventory sidebar by enabling <tt>perm_invent</tt> Furey: /* Configuration options */ Delete classic_status. It's not even an option in 3.6.7 (option error on startup). Also, I tested every option in the table on NAO 3.6.7, and they are all valid options, although a term_rows and term_cols are no-ops. 2024-05-22T14:51:54Z ‎Configuration options: Delete classic_status. It's not even an option in 3.6.7 (option error on startup). Also, I tested every option in the table on NAO 3.6.7, and they are all valid options, although a term_rows and term_cols are no-ops. ← Older revision Revision as of 14:51, 22 May 2024 Line 73: Line 73: |<tt>OPTIONS=perm_invent</tt> |<tt>OPTIONS=perm_invent</tt> |Show a permanent inventory window as a sidebar. |Show a permanent inventory window as a sidebar. − |- − |<tt>OPTIONS=classic_status</tt> − |Whether to use a 2-line status display akin to tty display (TRUE), or a 3-line status bar similar to the one NetHack4 and its variants has (FALSE). On NetHack 3.x, classic_status defaults to TRUE. This option is currently ignored in NetHack 3.6.x. |} |} Furey: /* Configuration options */ make 3.6.x options the baseline; describe 3.4.3 options as alternatives. 2024-05-22T14:49:45Z ‎Configuration options: make 3.6.x options the baseline; describe 3.4.3 options as alternatives. ← Older revision Revision as of 14:49, 22 May 2024 Line 33: Line 33: |'''Use this to enable curses interface''', if the binary was compiled with multiple window interfaces, and curses is not the default. |'''Use this to enable curses interface''', if the binary was compiled with multiple window interfaces, and curses is not the default. |- |- − |<tt>OPTIONS=IBMgraphics + |OPTIONS=symset:IBMgraphics</tt> − OPTIONS=symset:IBMgraphics</tt> + |Set this for Windows systems, or for PDCurses for SDL on any system. The latter uses a cp437 font, which works with this option. For 3.4.3, use <tt>OPTIONS=IBMgraphics</tt>. − |Set this for Windows systems, or for PDCurses for SDL on any system. The latter uses a cp437 font, which works with this option. Use the symset form on 3.6.x. |- |- − |<tt>OPTIONS=cursesgraphics + |OPTIONS=symset:curses</tt> − OPTIONS=symset:curses</tt> + |Set this if IBMgraphics above won't work for your system. Mutually exclusive with the above option, and should work on nearly any system. For 3.4.3, use <tt>OPTIONS=cursesgraphics</tt>. − |Set this if IBMgraphics above won't work for your system. Mutually exclusive with the above option, and should work on nearly any system. Use the symset form on 3.6.x. |- |- |<tt>OPTIONS=align_message:bottom |<tt>OPTIONS=align_message:bottom Umbire the Phantom: better to do it this way Furey 2024-05-22T07:02:00Z better to do it this way Furey ← Older revision Revision as of 07:02, 22 May 2024 Line 89: Line 89: *[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Curses interface bug tracker] *[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Curses interface bug tracker] + {{nethack-367|offset=1}} {{featured}} {{featured}} [[Category:User interface]] [[Category:User interface]] Furey: Remove some categories. This is not a 3.4.3 article; curses is a standard 3.6 feature now. And it's no longer a patch set. 2024-05-22T03:52:14Z Remove some categories. This is not a 3.4.3 article; curses is a standard 3.6 feature now. And it's no longer a patch set. ← Older revision Revision as of 03:52, 22 May 2024 Line 89: Line 89: *[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Curses interface bug tracker] *[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Curses interface bug tracker] − {{variant-343|offset=1}} {{featured}} {{featured}} [[Category:User interface]] [[Category:User interface]] − [[Category:Patches]] Furey: /* History */ Write some history. I checked nethack.org for the historical facts. Mark the external links for the 3.4.3 era patch as "historical value only". 2024-05-22T03:50:42Z ‎History: Write some history. I checked nethack.org for the historical facts. Mark the external links for the 3.4.3 era patch as "historical value only". ← Older revision Revision as of 03:50, 22 May 2024 Line 80: Line 80: |} |} − ==Links== + ==History== + + Karl Garrison developed the curses interface as a patch for NetHack 3.4.3. Both NAO and hardfought incorporated the curses interface patch in their servers. In NetHack 3.6.2, the devteam incorporated the curses interface into the vanilla codebase. + + The following links are of historical value only. + *[http://nethack-curses.wikia.com/ Curses interface homepage] *[http://nethack-curses.wikia.com/ Curses interface homepage] − *[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Bug tracker] + *[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Curses interface bug tracker] {{variant-343|offset=1}} {{variant-343|offset=1}}

@@ Line 21: / Line 21: @@
 [[nethack.alt.org]] currently hosts [[NetHack 3.6.7]], which has the curses interface enabled as an alternative to the standard [[ASCII]] interface.
-[[Hardfought]] offers the curses interface for almost every variant hosted, save for [[NetHack 1.3d]], [[Slash'EM]], [[SlashTHEM]] and [[ZapM]].
+[[Hardfought]] offers the curses interface for almost every variant hosted, save for [[NetHack 1.3d]], [[Slash'EM]], [[SlashTHEM]] and [[ZAPM]].
 [[DynaHack]] uses the curses interface by default.

@@ Line 1: / Line 1: @@
 [[File:Expanded-status.png|thumbnail|right|400px]]
+The '''curses interface''' is an alternate text-mode [[user interface]] for ''[[NetHack]]'' that uses high-level [[wikipedia:Curses (programming library)|curses]] routines to control the display. The curses interface has additional features compared to the traditional tty interface, such as dynamic window resizing, dynamic configurable placement of status and message windows, and mouse support.
 ==Features==
 Some features of this interface compared to the traditional tty interface include:
@@ Line 19: / Line 16: @@
 ==Public servers==
-[[nethack.alt.org]] currently hosts [[NetHack 3.6.7]], which has the curses interface enabled as an alternative to the standard [[ASCII]] interface.
+The following public servers utilize the curses interface:
-[[Hardfought]] offers the curses interface for almost every variant hosted, save for [[NetHack 1.3d]], [[Slash'EM]], [[SlashTHEM]] and [[ZAPM]].
+* [[nethack.alt.org]] currently hosts [[NetHack 3.6.7]], which has the curses interface enabled as an alternative to the standard [[ASCII]] interface.
-[[DynaHack]] uses the curses interface by default.
+[[NetHack 4]] and its derivatives [[NetHack Fourk]] and [[FIQHack]] use a libuncursed interface, which appears similar to curses.
 ==Configuration options==
+Some configuration [[option]]s that are specific to the curses windowport or otherwise relevant are shown below.
 {|class="prettytable striped"
@@ Line 78: / Line 74: @@
 ==History==
+Karl Garrison developed the curses interface as a patch for [[NetHack 3.4.3]], and both NAO and hardfought incorporated the curses interface patch in their servers. In [[NetHack 3.6.2]], the devteam incorporated the curses interface into the vanilla codebase.
 ===3.4.3 Options===
+For NetHack 3.4.3 and some derived variants, <tt>OPTIONS=classic_status</tt> is a boolean option. If FALSE, the status bar has 3 lines. If TRUE, the status display has 2 lines. The default value is TRUE.
 ===Historical Links===
-The following links are of historical value only.
+* [http://nethack-curses.wikia.com/ Curses interface homepage]
 * [http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Curses interface bug tracker]
 {{nethack-367|offset=1}}
 {{featured}}
 [[Category:User interface]]

@@ Line 23: / Line 23: @@
 [[Hardfought]] offers the curses interface for almost every variant hosted, save for [[NetHack 1.3d]], [[Slash'EM]], [[SlashTHEM]] and [[ZapM]].
-[[NetHack 4]] and its derivatives [[NetHack Fourk]] and [[FIQHack]], as well as [[DynaHack]] use the curses interface by default; any server which hosts these variants supports it.
+[[DynaHack]] uses the curses interface by default.
 ==Configuration options==
@@ Line 33: / Line 35: @@
 |'''Use this to enable curses interface''', if the binary was compiled with multiple window interfaces, and curses is not the default.
 |-
-|OPTIONS=symset:IBMgraphics</tt>
+|<tt>OPTIONS=symset:IBMgraphics</tt>
 |Set this for Windows systems, or for PDCurses for SDL on any system. The latter uses a cp437 font, which works with this option. For 3.4.3, use <tt>OPTIONS=IBMgraphics</tt>.
 |-
-|OPTIONS=symset:curses</tt>
+|<tt>OPTIONS=symset:curses</tt>
 |Set this if IBMgraphics above won't work for your system. Mutually exclusive with the above option, and should work on nearly any system.  For 3.4.3, use <tt>OPTIONS=cursesgraphics</tt>.
 |-

← Older revision		Revision as of 15:17, 22 May 2024
Line 78:		Line 78:

	Karl Garrison developed the curses interface as a patch for NetHack 3.4.3. Both NAO and hardfought incorporated the curses interface patch in their servers. In NetHack 3.6.2, the devteam incorporated the curses interface into the vanilla codebase.		Karl Garrison developed the curses interface as a patch for NetHack 3.4.3. Both NAO and hardfought incorporated the curses interface patch in their servers. In NetHack 3.6.2, the devteam incorporated the curses interface into the vanilla codebase.
		+
		+	===3.4.3 Options===
		+
		+	<tt>OPTIONS=classic_status</tt> is a boolean option. If FALSE, the status bar has 3 lines. If TRUE, the status display has 2 lines. The default value is TRUE.
		+
		+	===Historical Links===

	The following links are of historical value only.		The following links are of historical value only.

@@ Line 15: / Line 15: @@
 * Fancier display (e.g. window borders, optional popup dialogs, splash screen, and better menus)
 * Improved keyboard navigation of menus
-* "cursesgraphics" option for fancier line-drawing characters for drawing the dungeon&mdash;this should work on most terminals and platforms
+* "symset:curses" option for fancier line-drawing characters for drawing the dungeon&mdash;this should work on most terminals and platforms
 * Ability to have a permanent inventory sidebar by enabling <tt>perm_invent</tt>

@@ Line 73: / Line 73: @@
 |<tt>OPTIONS=perm_invent</tt>
 |Show a permanent inventory window as a sidebar.
 |}

@@ Line 80: / Line 80: @@
 |}
-==Links==
+==History==
 *[http://nethack-curses.wikia.com/ Curses interface homepage]
-*[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Bug tracker]
+*[http://sourceforge.net/tracker/?group_id=317683&atid=1336046 Curses interface bug tracker]
 {{variant-343|offset=1}}

Curses interface - Revision history

Umbire the Phantom: formatting + copyedit pass

Furey: ZapM -> ZAPM. In this case I want the article to use the correct capitalization, not have a redirect. Fixes one redlink.

Noisytoot: Add missing tags and clarify that nh4 and variants use libuncursed, not curses

Furey: /* History */ 3.4.3 options.

Furey: /* Features */ cursesgraphics -> symset:curses. "cursesgraphics" was 3.4.3, "symset:curses" is 3.6.7.

Furey: /* Configuration options */ Delete classic_status. It's not even an option in 3.6.7 (option error on startup). Also, I tested every option in the table on NAO 3.6.7, and they are all valid options, although a term_rows and term_cols are no-ops.

Furey: /* Configuration options */ make 3.6.x options the baseline; describe 3.4.3 options as alternatives.

Umbire the Phantom: better to do it this way Furey

Furey: Remove some categories. This is not a 3.4.3 article; curses is a standard 3.6 feature now. And it's no longer a patch set.

Furey: /* History */ Write some history. I checked nethack.org for the historical facts. Mark the external links for the 3.4.3 era patch as "historical value only".

Noisytoot: Add missing `tags and clarify that nh4 and variants use libuncursed, not curses`