CMakeLists.txt:prevent generation of man pages

closes #229
This commit is contained in:
andy5995
2018-09-15 13:20:41 -05:00
committed by Andy Alt
parent f324f46d4b
commit b2e81a80e2
8 changed files with 725 additions and 139 deletions

View File

@@ -44,16 +44,6 @@ OPTION(WANT_USE_GoogleBreakpad "Enable GoogleBreakpad support." ON)
OPTION(WANT_USE_STREFLOP "Use the library streflop." ON)
OPTION(WANT_USE_XercesC "Enable libXercesC support." OFF)
FIND_PROGRAM(HELP2MAN "help2man")
set(XVFB_EXEC "")
find_program(XVFB_RUN NAMES "xvfb-run")
if (NOT ${XVFB_RUN} MATCHES "XVFB_RUN-NOTFOUND")
set(XVFB_EXEC ${XVFB_RUN})
message(STATUS "Using xvfb-run to run man2help.")
endif()
MARK_AS_ADVANCED(HELP2MAN XVFB_RUN)
include(${CMAKE_SOURCE_DIR}/mk/cmake/Modules/SpecialMacros.cmake)
include(${CMAKE_SOURCE_DIR}/mk/cmake/Modules/ReqVersAndStaticConf.cmake)
MESSAGE(STATUS "=====================================================================")
@@ -318,7 +308,7 @@ SET(SDL_VERSION_SNAME "sdl")
IF (NOT ZETAGLEST_BIN_INSTALL_PATH STREQUAL "")
SET(ZETAGLEST_BIN_OUTPUT_DIR "${CMAKE_INSTALL_PREFIX}/bin")
ELSE()
SET(ZETAGLEST_BIN_OUTPUT_DIR "${ZETAGLEST_BIN_INSTALL_PREFIX}")
SET(ZETAGLEST_BIN_OUTPUT_DIR "${ZETAGLEST_BIN_INSTALL_PATH}")
ENDIF()
OPTION(WANT_DEV_OUTPATH "Use developer friendly output paths." OFF)

39
packaging/NOTES Normal file
View File

@@ -0,0 +1,39 @@
temp notes file (-andy5995)
# common options for Cmake prior to `make install`
cmake .. -DCMAKE_INSTALL_PREFIX=$HOME/local \
-DZETAGLEST_DATA_INSTALL_PATH=$HOME/local/data/zetaglest \
-DZETAGLEST_BIN_INSTALL_PATH=games
Install the project...
-- Install configuration: "RelWithDebInfo"
-- Up-to-date: /home/andy/local/bin/zetaglest
-- Installing: /home/andy/local/share/man/man6/zetaglest.6
-- Installing: /home/andy/local/data/zetaglest/start_zetaglest_gameserver
-- Installing: /home/andy/local/data/zetaglest/glestkeys.ini
-- Installing: /home/andy/local/data/zetaglest/servers.ini
-- Installing: /home/andy/local/data/zetaglest/glest.ini
-- Installing: /home/andy/local/data/zetaglest/zetaglest.ico
-- Installing: /home/andy/local/bin/zetaglest_editor
-- Installing: /home/andy/local/share/man/man6/zetaglest_editor.6
-- Installing: /home/andy/local/data/zetaglest/editor.ico
-- Installing: /home/andy/local/bin/zetaglest_g3dviewer
-- Installing: /home/andy/local/share/man/man6/zetaglest_g3dviewer.6
-- Installing: /home/andy/local/data/zetaglest/g3dviewer.ico
FIXME: If ZETAGLEST_BIN_INSTALL_PATH is an absolute path, it tries to install
/usr/local/bin
# generating the man page
COMMAND ${XVFB_EXEC} --auto-servernum --server-num=770
${HELP2MAN} --name="3D multi-player real time strategy game" --section=6 -N -o
${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}
DEPENDS ${TARGET_NAME})
ELSE()
add_custom_target(${TARGET_NAME_MANPAGE} ALL
COMMAND ${HELP2MAN} --name="${ZG_MANPAGE_DESCRIPTION}" --section=6 -N -o ${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}

View File

@@ -183,15 +183,8 @@ IF(BUILD_ZETAGLEST_MODEL_VIEWER)
SET(EXECUTABLE_OUTPUT_PATH "${ZETAGLEST_FRIENDLY_OUTPUT_PATH}")
ENDIF()
SET(HELP2MAN_OUT_PATH ${EXECUTABLE_OUTPUT_PATH})
IF("${EXECUTABLE_OUTPUT_PATH}" STREQUAL "")
SET(HELP2MAN_OUT_PATH "${CMAKE_CURRENT_BINARY_DIR}/")
ENDIF()
MESSAGE(STATUS "\n***Note: The final output path for ZetaGlest G3d Viewer will be [${ZETAGLEST_BIN_OUTPUT_DIR}]\n")
FIND_PROGRAM(HELP2MAN "help2man")
SET_SOURCE_FILES_PROPERTIES(${MG_INCLUDE_FILES} PROPERTIES HEADER_FILE_ONLY 1)
ADD_EXECUTABLE(${TARGET_NAME} ${MG_SOURCE_FILES} ${MG_INCLUDE_FILES})
@@ -203,44 +196,21 @@ IF(BUILD_ZETAGLEST_MODEL_VIEWER)
TARGET_LINK_LIBRARIES(${TARGET_NAME} libzetaglest)
TARGET_LINK_LIBRARIES(${TARGET_NAME} ${EXTERNAL_LIBS})
IF(EXISTS ${HELP2MAN} AND NOT APPLE)
# on mac <> --help sometimes hangs, so we need "NOT APPLE" ^ or some timeout here for now
MESSAGE(STATUS "***-- Found help2man: ${HELP2MAN} about to build manpage in [${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE}]")
# Requires an install prefix for the items below to work
IF(NOT CMAKE_INSTALL_PREFIX STREQUAL "")
# Installation of the program
INSTALL(TARGETS
${TARGET_NAME}
DESTINATION ${ZETAGLEST_BIN_OUTPUT_DIR})
SET(MG_MANPAGE_DESCRIPTION "G3D Model editor for the popular 3D realtime strategy game")
# Installation of the program manpage file
INSTALL(FILES
"${PROJECT_SOURCE_DIR}/${TARGET_NAME_MANPAGE}"
DESTINATION ${ZETAGLEST_MANPAGE_INSTALL_PATH})
IF(EXISTS ${XVFB_EXEC})
MESSAGE(STATUS "***-- Found xvfb-run: ${XVFB_EXEC} about to build manpage with it.")
add_custom_target(${TARGET_NAME_MANPAGE} ALL
COMMAND ${XVFB_EXEC} --auto-servernum --server-num=770 ${HELP2MAN} --no-discard-stderr --name="${MG_MANPAGE_DESCRIPTION}" --source="${TARGET_NAME}" --version-string="${TARGET_NAME}" --section=6 -N -o ${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}
DEPENDS ${TARGET_NAME})
ELSE()
add_custom_target(${TARGET_NAME_MANPAGE} ALL
COMMAND ${HELP2MAN} --no-discard-stderr --name="${MG_MANPAGE_DESCRIPTION}" --source="${TARGET_NAME}" --version-string="${TARGET_NAME}" --section=6 -N -o ${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}
DEPENDS ${TARGET_NAME})
ENDIF()
# Installation of the program config and image files
INSTALL(FILES
"${PROJECT_SOURCE_DIR}/mk/shared/g3dviewer.ico"
DESTINATION ${ZETAGLEST_INI_INSTALL_PATH})
ENDIF()
# Requires an install prefix for the items below to work
IF(NOT CMAKE_INSTALL_PREFIX STREQUAL "")
# Installation of the program
INSTALL(TARGETS
${TARGET_NAME}
DESTINATION ${ZETAGLEST_BIN_OUTPUT_DIR})
IF(EXISTS ${HELP2MAN} AND NOT "${ZETAGLEST_MANPAGE_INSTALL_PATH}" STREQUAL "" AND NOT APPLE)
MESSAGE(STATUS "**NOTE: Will Install manpage [${TARGET_NAME_MANPAGE}] to [${ZETAGLEST_MANPAGE_INSTALL_PATH}]")
# Installation of the program manpage file
INSTALL(FILES
"${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE}"
DESTINATION ${ZETAGLEST_MANPAGE_INSTALL_PATH})
ENDIF()
# Installation of the program config and image files
INSTALL(FILES
"${PROJECT_SOURCE_DIR}/mk/shared/g3dviewer.ico"
DESTINATION ${ZETAGLEST_INI_INSTALL_PATH})
ENDIF()
ENDIF()

View File

@@ -300,48 +300,22 @@ IF(BUILD_ZETAGLEST)
ENDIF()
TARGET_LINK_LIBRARIES(${TARGET_NAME} ${EXTERNAL_LIBS})
SET(HELP2MAN_OUT_PATH ${EXECUTABLE_OUTPUT_PATH})
IF("${EXECUTABLE_OUTPUT_PATH}" STREQUAL "")
SET(HELP2MAN_OUT_PATH "${CMAKE_CURRENT_BINARY_DIR}/")
ENDIF()
IF(EXISTS ${HELP2MAN})
MESSAGE(STATUS "***-- Found help2man: ${HELP2MAN} about to build manpage in [${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE}]")
SET(ZG_MANPAGE_DESCRIPTION "3D multi-player real time strategy game")
IF(EXISTS ${XVFB_EXEC})
MESSAGE(STATUS "***-- Found xvfb-run: ${XVFB_EXEC} about to build manpage with it.")
add_custom_target(${TARGET_NAME_MANPAGE} ALL
COMMAND ${XVFB_EXEC} --auto-servernum --server-num=770 ${HELP2MAN} --name="${ZG_MANPAGE_DESCRIPTION}" --section=6 -N -o ${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}
DEPENDS ${TARGET_NAME})
ELSE()
add_custom_target(${TARGET_NAME_MANPAGE} ALL
COMMAND ${HELP2MAN} --name="${ZG_MANPAGE_DESCRIPTION}" --section=6 -N -o ${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}
DEPENDS ${TARGET_NAME})
ENDIF()
IF (NOT ZG_CMAKE_INSTALL_PREFIX STREQUAL "")
SET(CMAKE_INSTALL_PREFIX "${ZG_CMAKE_INSTALL_PREFIX}")
ENDIF()
# Requires an install prefix for the items below to work
IF(NOT CMAKE_INSTALL_PREFIX STREQUAL "")
MESSAGE(STATUS "**Source package INSTALL TRIGGERED [${PROJECT_SOURCE_DIR}]")
IF (NOT ZG_CMAKE_INSTALL_PREFIX STREQUAL "")
SET(CMAKE_INSTALL_PREFIX "${ZG_CMAKE_INSTALL_PREFIX}")
ENDIF()
# Requires an install prefix for the items below to work
IF(NOT CMAKE_INSTALL_PREFIX STREQUAL "")
MESSAGE(STATUS "**Source package INSTALL TRIGGERED [${PROJECT_SOURCE_DIR}]")
# Installation of the program
INSTALL(TARGETS
${TARGET_NAME}
DESTINATION "${ZETAGLEST_BIN_OUTPUT_DIR}")
# Installation of the program
INSTALL(TARGETS
${TARGET_NAME}
DESTINATION "${ZETAGLEST_BIN_OUTPUT_DIR}")
IF(EXISTS ${HELP2MAN} AND NOT "${ZETAGLEST_MANPAGE_INSTALL_PATH}" STREQUAL "")
MESSAGE(STATUS "**NOTE: Will Install manpage [${TARGET_NAME_MANPAGE}] to [${ZETAGLEST_MANPAGE_INSTALL_PATH}]")
# Installation of the program manpage file
INSTALL(FILES
"${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE}"
DESTINATION ${ZETAGLEST_MANPAGE_INSTALL_PATH})
ENDIF()
# Installation of the program manpage file
INSTALL(FILES
"${PROJECT_SOURCE_DIR}/${TARGET_NAME_MANPAGE}"
DESTINATION ${ZETAGLEST_MANPAGE_INSTALL_PATH})
IF(UNIX)
INSTALL(PROGRAMS

View File

@@ -163,15 +163,8 @@ IF(BUILD_ZETAGLEST_MAP_EDITOR)
SET(EXECUTABLE_OUTPUT_PATH "${ZETAGLEST_FRIENDLY_OUTPUT_PATH}")
ENDIF()
SET(HELP2MAN_OUT_PATH ${EXECUTABLE_OUTPUT_PATH})
IF("${EXECUTABLE_OUTPUT_PATH}" STREQUAL "")
SET(HELP2MAN_OUT_PATH "${CMAKE_CURRENT_BINARY_DIR}/")
ENDIF()
MESSAGE(STATUS "\n***Note: The final output path for ZetaGlest Map Editor will be [${ZETAGLEST_BIN_OUTPUT_DIR}]\n")
FIND_PROGRAM(HELP2MAN "help2man")
SET_SOURCE_FILES_PROPERTIES(${MG_INCLUDE_FILES} PROPERTIES HEADER_FILE_ONLY 1)
ADD_EXECUTABLE(${TARGET_NAME} ${MG_SOURCE_FILES} ${MG_INCLUDE_FILES})
@@ -192,44 +185,20 @@ IF(BUILD_ZETAGLEST_MAP_EDITOR)
TARGET_LINK_LIBRARIES(${TARGET_NAME} libzetaglest)
TARGET_LINK_LIBRARIES(${TARGET_NAME} ${EXTERNAL_LIBS})
IF(EXISTS ${HELP2MAN} AND NOT APPLE)
# on mac <> --help sometimes hangs, so we need "NOT APPLE" ^ or some timeout here for now
MESSAGE(STATUS "***-- Found help2man: ${HELP2MAN} about to build manpage in [${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE}]")
# Requires an install prefix for the items below to work
IF(NOT CMAKE_INSTALL_PREFIX STREQUAL "")
# Installation of the program
INSTALL(TARGETS
${TARGET_NAME}
DESTINATION ${ZETAGLEST_BIN_OUTPUT_DIR})
# Installation of the program manpage file
INSTALL(FILES
"${PROJECT_SOURCE_DIR}/${TARGET_NAME_MANPAGE}"
DESTINATION ${ZETAGLEST_MANPAGE_INSTALL_PATH})
SET(MG_MANPAGE_DESCRIPTION "Map editor for the popular 3D realtime strategy game")
IF(EXISTS ${XVFB_EXEC})
MESSAGE(STATUS "***-- Found xvfb-run: ${XVFB_EXEC} about to build manpage with it.")
add_custom_target(${TARGET_NAME_MANPAGE} ALL
COMMAND ${XVFB_EXEC} --auto-servernum --server-num=770 ${HELP2MAN} --no-discard-stderr --name="${MG_MANPAGE_DESCRIPTION}" --source="${TARGET_NAME}" --version-string="${TARGET_NAME}" --section=6 -N -o ${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}
DEPENDS ${TARGET_NAME})
ELSE()
add_custom_target(${TARGET_NAME_MANPAGE} ALL
COMMAND ${HELP2MAN} --no-discard-stderr --name="${MG_MANPAGE_DESCRIPTION}" --source="${TARGET_NAME}" --version-string="${TARGET_NAME}" --section=6 -N -o ${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE} ${HELP2MAN_OUT_PATH}${TARGET_NAME}
DEPENDS ${TARGET_NAME})
ENDIF()
# Installation of the program config and image files
INSTALL(FILES
"${PROJECT_SOURCE_DIR}/mk/shared/editor.ico"
DESTINATION ${ZETAGLEST_INI_INSTALL_PATH})
ENDIF()
# Requires an install prefix for the items below to work
IF(NOT CMAKE_INSTALL_PREFIX STREQUAL "")
# Installation of the program
INSTALL(TARGETS
${TARGET_NAME}
DESTINATION ${ZETAGLEST_BIN_OUTPUT_DIR})
IF(EXISTS ${HELP2MAN} AND NOT "${ZETAGLEST_MANPAGE_INSTALL_PATH}" STREQUAL "" AND NOT APPLE)
MESSAGE(STATUS "**NOTE: Will Install manpage [${TARGET_NAME_MANPAGE}] to [${ZETAGLEST_MANPAGE_INSTALL_PATH}]")
# Installation of the program manpage file
INSTALL(FILES
"${HELP2MAN_OUT_PATH}${TARGET_NAME_MANPAGE}"
DESTINATION ${ZETAGLEST_MANPAGE_INSTALL_PATH})
ENDIF()
# Installation of the program config and image files
INSTALL(FILES
"${PROJECT_SOURCE_DIR}/mk/shared/editor.ico"
DESTINATION ${ZETAGLEST_INI_INSTALL_PATH})
ENDIF()
ENDIF()

462
zetaglest.6 Normal file
View File

@@ -0,0 +1,462 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.5.
.TH ZETAGLEST "6" "September 2018" "zetaglest v0.8.02" "Games"
.SH NAME
zetaglest \- 3D\ multi-player\ real\ time\ strategy\ game
.SH SYNOPSIS
.B zetaglest
[\fI\,OPTION\/\fR]... \fI\,VALUE\/\fR...
.SH DESCRIPTION
Options for running zetaglest from the command line
.HP
\fB\-\-help\fR
.IP
display usage
.HP
\fB\-\-autostart\-lastgame\fR
.IP
Automatically starts a game with the last settings played
.HP
\fB\-\-load\-saved\-game\fR=\fI\,FILE\/\fR
.IP
Loads the last saved game.
.IP
FILE \- optional name of the saved game file to load.
If FILE is not specified, the last game that was saved is loaded
.HP
\fB\-\-auto\-test\fR=\fI\,x\/\fR,y,z
.IP
Run in auto test mode
.IP
x \- optional maximum # seconds to play.
.IP
If 'x' is not specified the default is 1200 seconds (20 minutes).
.IP
y \- optional game settings file to play.
.IP
If 'y' is not specified (or is empty) then auto test cycles
through playing scenarios.
.IP
z \- the word 'exit' indicating the game should exit after the game
.IP
is finished or the time runs out. If 'z' is not specified
(or is empty) then auto test continues to cycle.
.HP
\fB\-\-connect\fR=\fI\,x\/\fR:y
.IP
Auto connect to host server at IP or hostname x using port y.
Shortcut version of using \fB\-\-connecthost\fR and \fB\-\-use\-ports\fR.
*NOTE: to automatically connect to the first LAN host you may use:
.HP
\fB\-\-connect\fR=\fI\,auto\-connect\/\fR
.HP
\fB\-\-connecthost\fR=\fI\,x\/\fR
.IP
Auto connect to host server at IP or hostname x.
*NOTE: to automatically connect to the first LAN host you may use
.HP
\fB\-\-connecthost\fR=\fI\,auto\-connect\/\fR
.HP
\fB\-\-starthost\fR
.IP
Auto create a host server.
.HP
\fB\-\-headless\-server\-mode\fR=\fI\,x\/\fR,x
.IP
Run as a headless server.
Where 'x' is an optional comma delimited command list of one or
more of the following:
.TP
exit
\- the application quits after all players have disconnected
.TP
vps
\- commands from the local console are NOT read (for some vps's)
.TP
lan
\- prevents broadcasting the hosting server to the masterserver
(for local LAN games).
.HP
\fB\-\-headless\-server\-status\fR
.IP
Check the current status of a headless server
.HP
\fB\-\-use\-ports\fR=\fI\,x\/\fR,y,z
.IP
Force hosted games to listen internally on port 'x', externally on
port 'y' and for game status on port 'z'
.IP
\&'x' \- internal listening port on the local machine
\&'y' \- external port on the router/proxy from which to forward connections
.IP
to the internal port
.IP
\&'z' \- game status port on the local machine from which to listen
.IP
for status requests
.IP
NOTE: If enabled, the FTP Server port's will be set to x+1 to x+9.
.HP
\fB\-\-server\-title\fR=\fI\,x\/\fR
.IP
Set server title.
.HP
\fB\-\-load\-scenario\fR=\fI\,x\/\fR
.IP
Auto load a scenario by scenario name.
.HP
\fB\-\-load\-mod\fR=\fI\,x\/\fR
.IP
Auto load a mod by mod pathname.
.HP
\fB\-\-preview\-map\fR=\fI\,Map\/\fR,Tileset
.IP
Auto Preview a map by map name. (tileset is optional)
.HP
\fB\-\-version\fR
.IP
Displays the version string of this program.
.HP
\fB\-\-opengl\-info\fR
.IP
Displays your video driver's OpenGL info.
.HP
\fB\-\-sdl\-info\fR
.IP
Displays your SDL version information.
.HP
\fB\-\-lua\-info\fR
.IP
Displays your LUA version information.
.HP
\fB\-\-lua\-debug\fR
.IP
Displays LUA debug information.
.HP
\fB\-\-curl\-info\fR
.IP
Displays your CURL version information.
.HP
\fB\-\-xerces\-info\fR
.IP
Displays your XERCES version information.
.HP
\fB\-\-validate\-techtrees\fR=\fI\,x=purgeunused=purgeduplicates=gitdelete=hideduplicates\/\fR
.IP
Display a report detailing any known problems related to
your selected techtrees game data.
.TP
x
\- comma\-delimited list of techtrees to validate
.TP
purgeunused
\- optional parameter telling the validation to delete
.IP
extra files in the techtree that are not used
.TP
purgeduplicates \- optional parameter telling the validation to merge
duplicate files in the techtree
.TP
gitdelete
\- optional parameter telling the validation to call
.IP
\&'git rm' on duplicate and unused files in the techtree
.TP
hideduplicates
\- optional parameter telling the validation to NOT
.TP
SHOW duplicate files in the techtree
*NOTE: This only applies when files are purged due to
the above flags being set.
.IP
example:
.IP
zetaglest \fB\-\-validate\-techtrees\fR=\fI\,zetapack\/\fR,vbros_pack_5
.PP
\fB\-\-validate\-factions\fR=\fI\,x=purgeunused=purgeduplicates=hideduplicates\/\fR
.IP
Display a report detailing any known problems related to
.IP
your selected factions game data.
.IP
Where x is a comma\-delimited list of factions to validate.
.IP
Where 'purgeunused' is an optional parameter telling the
.IP
validation to delete extra files in the faction that are
.IP
not used.
.IP
Where 'purgeduplicates' is an optional parameter telling the
.IP
validation to merge duplicate files in the faction.
.IP
Where 'hideduplicates' is an optional parameter telling the
.IP
validation to NOT SHOW duplicate files in the techtree.
.IP
*NOTE: leaving the list empty is the same as running:
.IP
\fB\-\-validate\-techtrees\fR
.IP
example: zetaglest \fB\-\-validate\-factions\fR=\fI\,tech\/\fR,egypt
.PP
\fB\-\-validate\-scenario\fR=\fI\,x=purgeunused=gitdelete\/\fR
.IP
Display a report detailing any known problems related to
.IP
your selected scenario game data.
.IP
Where x is a single scenario to validate.
.IP
Where 'purgeunused' is an optional parameter telling the
.IP
validation to delete extra files in the scenario that
.IP
are not used.
.IP
example: zetaglest \fB\-\-validate\-scenario\fR=\fI\,stranded\/\fR
.PP
\fB\-\-validate\-tileset\fR=\fI\,x=purgeunused=gitdelete\/\fR
.IP
Display a report detailing any known problems related to
.IP
your selected tileset game data.
.IP
Where x is a single tileset to validate.
.IP
Where 'purgeunused' is an optional parameter telling the
.IP
validation to delete extra files in the tileset that
.IP
are not used.
.IP
example: zetaglest \fB\-\-validate\-tileset\fR=\fI\,desert2\/\fR
.PP
\fB\-\-translate\-techtrees\fR=\fI\,x\/\fR
.IP
Produces a default lng file for the specified techtree to
.IP
prepare for translation into other languages.
.IP
Where x is a techtree name.
.PP
\fB\-\-list\-maps\fR=\fI\,x\/\fR Display a list of game content: maps.
.IP
Where x is an optional name filter.
.IP
example: zetaglest \fB\-\-list\-maps\fR=\fI\,island\/\fR*
.PP
\fB\-\-list\-techtrees\fR=\fI\,showfactions\/\fR
.IP
Display a list of game content: techtrees.
.IP
Where 'showfactions' is an optional parameter to display
.IP
factions in each techtree.
.IP
example: zetaglest \fB\-\-list\-techtrees\fR=\fI\,showfactions\/\fR
.PP
\fB\-\-list\-scenarios\fR=\fI\,x\/\fR Display a list of game content: scenarios.
.IP
Where x is an optional name filter.
.IP
example: zetaglest \fB\-\-list\-scenarios\fR=\fI\,beginner\/\fR*
.PP
\fB\-\-list\-tilesets\fR=\fI\,x\/\fR Display a list of game content: tilesets.
.IP
Where x is an optional name filter.
.IP
example: zetaglest \fB\-\-list\-tilesets\fR=\fI\,f\/\fR*
.PP
\fB\-\-list\-tutorials\fR=\fI\,x\/\fR Display a list of game content: tutorials.
.IP
Where x is an optional name filter.
.IP
example: zetaglest \fB\-\-list\-tutorials=\fR*
.PP
\fB\-\-data\-path\fR=\fI\,x\/\fR Sets the game data path to x.
.IP
example:
.IP
zetaglest \fB\-\-data\-path=\fR/usr/local/game_data/
.PP
\fB\-\-ini\-path\fR=\fI\,x\/\fR Sets the game ini path to x.
.IP
example: zetaglest \fB\-\-ini\-path=\fR~/game_config/
.PP
\fB\-\-log\-path\fR=\fI\,x\/\fR Sets the game logs path to x.
.IP
example: zetaglest \fB\-\-log\-path=\fR~/game_logs/
.PP
\fB\-\-font\-path\fR=\fI\,x\/\fR Sets the game fonts path to x.
.IP
example: zetaglest \fB\-\-font\-path=\fR~/myfonts/
.PP
\fB\-\-show\-ini\-settings\fR=\fI\,x\/\fR Display merged ini settings information.
.IP
Where x is an optional property name to filter (default
.IP
shows all).
.IP
example:
.IP
zetaglest \fB\-\-show\-ini\-settings\fR=\fI\,DebugMode\/\fR
.PP
\fB\-\-convert\-models\fR=\fI\,x=textureformat=keepsmallest\/\fR
.IP
Convert a model file or folder to the current g3d version
.IP
format.
.IP
Where x is a filename or folder containing the g3d model(s).
.IP
Where 'textureformat' is an optional supported texture
.IP
format to convert to (tga,bmp,jpg,png).
.IP
Where 'keepsmallest' is an optional flag indicating to keep
.IP
the original texture if its filesize is smaller than the
.IP
converted format.
.IP
example:
.IP
zetaglest \fB\-\-convert\-models\fR=\fI\,techs\/\fR/zetapack/factions/tech/
.IP
units/castle/models/castle.g3d=png=keepsmallest
.PP
\fB\-\-use\-language\fR=\fI\,x\/\fR Force the language to be the language specified
.IP
by x. Where x is a language filename or ISO639\-1 code.
.IP
example: zetaglest \fB\-\-use\-language\fR=\fI\,english\/\fR
.IP
example: zetaglest \fB\-\-use\-language\fR=\fI\,en\/\fR
.PP
\fB\-\-show\-map\-crc\fR=\fI\,x\/\fR Show the calculated CRC for the map named x.
.IP
Where x is a map name.
.IP
example: zetaglest \fB\-\-show\-map\-crc\fR=\fI\,four_rivers\/\fR
.PP
\fB\-\-show\-tileset\-crc\fR=\fI\,x\/\fR Show the calculated CRC for the tileset named x.
.IP
Where x is a tileset name.
.IP
example: zetaglest \fB\-\-show\-tileset\-crc\fR=\fI\,forest\/\fR
.PP
\fB\-\-show\-techtree\-crc\fR=\fI\,x\/\fR Show the calculated CRC for the techtree named x.
.IP
Where x is a techtree name.
.IP
example: zetaglest \fB\-\-show\-techtree\-crc\fR=\fI\,zetapack\/\fR
.PP
\fB\-\-show\-scenario\-crc\fR=\fI\,x\/\fR Show the calculated CRC for the scenario named x.
.IP
Where x is a scenario name.
.IP
example: zetaglest \fB\-\-show\-scenario\-crc\fR=\fI\,storming\/\fR
.PP
\fB\-\-show\-path\-crc\fR=\fI\,x=y\/\fR Show the calculated CRC for files in the path
.IP
located in x using file filter y.
.IP
Where x is a path name and y is file(s) filter.
.IP
example: zetaglest \fB\-\-show\-path\-crc\fR=\fI\,techs\/\fR/=zetapack.7z
.PP
\fB\-\-disable\-backtrace\fR Disables stack backtrace on errors.
.PP
\fB\-\-disable\-sigsegv\-handler\fR
.IP
Disables the sigsegv error handler.
.PP
\fB\-\-disable\-vbo\fR Disables trying to use Vertex Buffer Objects.
.PP
\fB\-\-disable\-vertex\-interpolation\fR
.IP
Disables interpolating animations to make them smoother.
.PP
\fB\-\-disable\-sound\fR Disables the sound system.
.PP
\fB\-\-enable\-legacyfonts\fR Enables using the legacy font system.
.PP
\fB\-\-resolution\fR=\fI\,x\/\fR Override the video resolution.
.IP
Where x is a string with the following format: 'width x height'.
.IP
example: zetaglest \fB\-\-resolution\fR=\fI\,1024x768\/\fR
.PP
\fB\-\-colorbits\fR=\fI\,x\/\fR Override the video colorbits.
.IP
Where x is a valid colorbits value supported by your video
.IP
driver.
.IP
example: zetaglest \fB\-\-colorbits\fR=\fI\,32\/\fR
.PP
\fB\-\-depthbits\fR=\fI\,x\/\fR Override the video depthbits.
.IP
Where x is a valid depthbits value supported by your video
.IP
driver.
.IP
example: zetaglest \fB\-\-depthbits\fR=\fI\,24\/\fR
.PP
\fB\-\-fullscreen\fR=\fI\,x\/\fR Override the video fullscreen mode.
.IP
Where x either true or false.
.IP
example: zetaglest \fB\-\-fullscreen\fR=\fI\,true\/\fR
.PP
\fB\-\-set\-gamma\fR=\fI\,x\/\fR Override the video gamma (contrast) value.
.IP
Where x is a floating point value.
.IP
example: zetaglest \fB\-\-set\-gamma\fR=\fI\,1\/\fR.5
.PP
\fB\-\-use\-font\fR=\fI\,x\/\fR Override the font to use.
.IP
Where x is the path and name of a font file supported by
.IP
freetype2.
.IP
example:
.IP
zetaglest \fB\-\-use\-font=\fR$APPLICATIONDATAPATH/data/core/fonts/Vera.ttf
.PP
\fB\-\-font\-basesize\fR=\fI\,x\/\fR Override the font base size.
.IP
Where x is the numeric base font size to use.
.IP
example: zetaglest \fB\-\-font\-basesize\fR=\fI\,5\/\fR
.PP
\fB\-\-disable\-videos\fR Disables video playback.
.PP
\fB\-\-disable\-opengl\-checks\fR
.IP
Disables opengl capability checks (for corrupt or flaky video
.IP
drivers).
.PP
\fB\-\-create\-data\-archives\fR=\fI\,x=y\/\fR
.IP
Compress selected game data into archives for network sharing.
.IP
Where x is one of the following data items to compress:
.IP
techtrees, tilesets or all.
.IP
Where y = include_main to include main (non mod) data.
.IP
example: zetaglest \fB\-\-create\-data\-archives\fR=\fI\,all\/\fR
.PP
\fB\-\-steam\fR=\fI\,x=y\/\fR
.IP
Run with Steam Client Integration.
.PP
\fB\-\-verbose\fR Displays verbose information in the console.
.PP
Compiled using: GNUC: 60300 [64bit] platform: Linux\-X64 endianness: little
version: [v0.8.02] \- using STREFLOP [SSE] \- [no\-denormals]

12
zetaglest_editor.6 Normal file
View File

@@ -0,0 +1,12 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.5.
.TH ZETAGLEST_EDITOR "6" "September 2018" "zetaglest_editor" "Games"
.SH NAME
zetaglest_editor \- Map\ editor\ for\ the\ popular\ 3D\ realtime\ strategy\ game
.SH DESCRIPTION
ZetaGlest map editor v0.8.01 [Using wxWidgets 3.0.2]
.PP
Creates or edits zetaglest/glest maps. [.mgm/.gbm]
.PP
Draw with left mouse button.
Move map with right mouse button.
Zoom with middle mouse button or mousewheel.

170
zetaglest_g3dviewer.6 Normal file
View File

@@ -0,0 +1,170 @@
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.5.
.TH ZETAGLEST_G3DVIEWER "6" "September 2018" "zetaglest_g3dviewer" "Games"
.SH NAME
zetaglest_g3dviewer \- G3D\ Model\ editor\ for\ the\ popular\ 3D\ realtime\ strategy\ game
.SH DESCRIPTION
Using wxWidgets version [3.0.2.0]
.PP
zetaglest_g3dviewer v0.8.01, [Using wxWidgets 3.0.2]
.PP
Displays glest 3D\-models and unit/projectile/splash particle systems.
.PP
Rotate with left mouse button. Zoom with right mouse button or mousewheel.
Use ctrl to load more than one particle system.
Press R to restart particles, this also reloads all files if they are changed.
.PP
zetaglest_g3dviewer [G3D FILE], usage
.PP
Commandline Parameter: Description:
.PP
\- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \- \-
.PP
\fB\-\-help\fR Displays this help text.
.PP
\fB\-\-load\-unit\fR=\fI\,x\/\fR Auto load the unit / skill information specified
.IP
in path/filename x.
.IP
Where x is a g3d filename to load separated with a
.IP
comma and one or more skill names to try loading.
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-load\-unit\fR=\fI\,techs\/\fR/zetapack/factions/
.IP
tech/units/battle_machine,attack_skill,stop_skill
.PP
\fB\-\-load\-model\fR=\fI\,x\/\fR Auto load the model specified in path/filename x.
.IP
Where x is a g3d filename to load.
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-load\-model\fR=\fI\,techs\/\fR/zetapack/factions/
.IP
tech/units/battle_machine/models/battle_machine_dying.g3d
.PP
\fB\-\-load\-model\-animation\-value\fR=\fI\,x\/\fR
.IP
Animation value when loading a model.
.IP
Where x is a decimal value from \fB\-1\fR.0 to 1.0
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-load\-model\-animation\-value\fR=\fI\,0\/\fR.5
.PP
\fB\-\-auto\-screenshot\fR=\fI\,x\/\fR Automatically takes a screenshot of the items you
.IP
are loading.
.IP
Where x is a comma\-delimited list of one or more
.IP
of the optional settings:
.IP
transparent, enable_grid, enable_wireframe,
.IP
enable_normals, disable_grid, disable_wireframe,
.IP
disable_normals, saveas\-<filename>, resize\-wxh
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-auto\-screenshot\fR=\fI\,transparent\/\fR,
.IP
disable_grid,saveas\-test.png,resize\-800x600
.IP
\fB\-\-load\-model\fR=\fI\,techs\/\fR/zetapack/factions/tech/units/
.IP
battle_machine/models/battle_machine_dying.g3d
.PP
\fB\-\-load\-particle\fR=\fI\,x\/\fR Auto load the particle specified in path/filename x.
.IP
Where x is a Particle XML filename to load.
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-load\-particle\fR=\fI\,techs\/\fR/zetapack/factions/
.IP
persian/units/genie/glow_particles.xml
.PP
\fB\-\-load\-projectile\-particle\fR=\fI\,x\/\fR
.IP
Auto load the projectile particle specified in
.IP
path/filename x.
.IP
Where x is a Projectile Particle Definition XML
.IP
filename to load.
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-load\-projectile\-particle\fR=\fI\,techs\/\fR/zetapack/
.IP
factions/persian/units/genie/particle_proj.xml
.PP
\fB\-\-load\-splash\-particle\fR=\fI\,x\/\fR
.IP
Auto load the splash particle specified in
.IP
path/filename x.
.IP
Where x is a Splash Particle Definition XML
.IP
filename to load.
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-load\-splash\-particle\fR=\fI\,techs\/\fR/zetapack/
.IP
factions/persian/units/genie/particle_splash.xml
.PP
\fB\-\-load\-particle\-loop\-value\fR=\fI\,x\/\fR
.IP
Particle loop value when loading one or more
.IP
particles.
.IP
Where x is an integer value from 1 to particle count.
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-load\-particle\-loop\-value\fR=\fI\,25\/\fR
.PP
\fB\-\-zoom\-value\fR=\fI\,x\/\fR Zoom value when loading a model.
.IP
Where x is a decimal value from 0.1 to 10.0
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-zoom\-value\fR=\fI\,4\/\fR.2
.PP
\fB\-\-rotate\-x\-value\fR=\fI\,x\/\fR X Coordinate Rotation value when loading a model.
.IP
Where x is a decimal value from \fB\-10\fR.0 to 10.0
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-rotate\-x\-value\fR=\fI\,2\/\fR.2
.PP
\fB\-\-rotate\-y\-value\fR=\fI\,x\/\fR Y Coordinate Rotation value when loading a model.
.IP
Where x is a decimal value from \fB\-10\fR.0 to 10.0
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-rotate\-y\-value\fR=\fI\,2\/\fR.2
.PP
\fB\-\-screenshot\-format\fR=\fI\,x\/\fR Specify which image format to use for screenshots.
.IP
Where x is one of the following supported formats:
.IP
png,jpg,tga,bmp
.IP
*NOTE: png is the default (and supports transparency)
.IP
example:
.IP
zetaglest_g3dviewer \fB\-\-screenshot\-format\fR=\fI\,jpg\/\fR