Skip to content

Commit

Permalink
Renamed Legacy to League
Browse files Browse the repository at this point in the history
  • Loading branch information
rmarquis committed May 16, 2020
1 parent 601c3d5 commit 762f048
Show file tree
Hide file tree
Showing 11 changed files with 39 additions and 39 deletions.
8 changes: 4 additions & 4 deletions Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -91,9 +91,9 @@ qthelp:
@echo
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/LegacyLuaAPI.qhcp"
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/LeagueLuaAPI.qhcp"
@echo "To view the help file:"
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/LegacyLuaAPI.qhc"
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/LeagueLuaAPI.qhc"

.PHONY: applehelp
applehelp:
Expand All @@ -110,8 +110,8 @@ devhelp:
@echo
@echo "Build finished."
@echo "To view the help file:"
@echo "# mkdir -p $$HOME/.local/share/devhelp/LegacyLuaAPI"
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/LegacyLuaAPI"
@echo "# mkdir -p $$HOME/.local/share/devhelp/LeagueLuaAPI"
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/LeagueLuaAPI"
@echo "# devhelp"

.PHONY: epub
Expand Down
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Legacy Lua API documentation [![Documentation Status](https://readthedocs.org/projects/legacy-lua-api/badge/?version=latest)](http://legacy-lua-api.readthedocs.io/en/latest/?badge=latest)
# League Lua API documentation [![Documentation Status](https://readthedocs.org/projects/etlegacy-lua-docs/badge/?version=latest)](http://etlegacy-lua-docs.readthedocs.io/en/latest/?badge=latest)

Legacy's Lua API is the interface for communication between Lua and Legacy mod.
League's Lua API is the interface for communication between Lua and League mod.

This documentation is generated with [Sphinx](http://www.sphinx-doc.org/) using the [reStructuredText](http://www.sphinx-doc.org/en/stable/rest.html) markup language.

It can be read online at [legacy-lua-api.rtfd.io](http://legacy-lua-api.rtfd.io).
It can be read online at [etlegacy-lua-docs.rtfd.io](http://etlegacy-lua-docs.rtfd.io).
2 changes: 1 addition & 1 deletion callbacks.rst
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Called when qagame runs a server frame.
et_Quit()
---------

Called when Legacy unloads the mod.
Called when League unloads the mod.

The mod should close all open filedescriptors and perform all cleanup.

Expand Down
16 changes: 8 additions & 8 deletions conf.py
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
#
# Legacy Lua API documentation build configuration file, created by
# League Lua API documentation build configuration file, created by
# sphinx-quickstart on Tue Sep 13 00:05:27 2016.
#
# This file is execfile()d with the current directory set to its
Expand Down Expand Up @@ -52,7 +52,7 @@
master_doc = 'index'

# General information about the project.
project = 'Legacy Lua API'
project = 'League Lua API'
copyright = '2012-2020, ET: Legacy Team'
author = 'ET: Legacy Team'

Expand Down Expand Up @@ -137,7 +137,7 @@
# The name for this set of Sphinx documents.
# "<project> v<release> documentation" by default.
#
# html_title = 'Legacy Lua API v2.76'
# html_title = 'League Lua API v2.76'

# A shorter title for the navigation bar. Default is the same as html_title.
#
Expand Down Expand Up @@ -237,7 +237,7 @@
# html_search_scorer = 'scorer.js'

# Output file base name for HTML help builder.
htmlhelp_basename = 'LegacyLuaAPIdoc'
htmlhelp_basename = 'LeagueLuaAPIdoc'

# -- Options for LaTeX output ---------------------------------------------

Expand All @@ -263,7 +263,7 @@
# (source start file, target name, title,
# author, documentclass [howto, manual, or own class]).
latex_documents = [
(master_doc, 'LegacyLuaAPI.tex', 'Legacy Lua API Documentation',
(master_doc, 'LeagueLuaAPI.tex', 'League Lua API Documentation',
'ET: Legacy Team', 'manual'),
]

Expand Down Expand Up @@ -305,7 +305,7 @@
# One entry per manual page. List of tuples
# (source start file, name, description, authors, manual section).
man_pages = [
(master_doc, 'legacyluaapi', 'Legacy Lua API Documentation',
(master_doc, 'leagueluaapi', 'League Lua API Documentation',
[author], 1)
]

Expand All @@ -320,8 +320,8 @@
# (source start file, target name, title, author,
# dir menu entry, description, category)
texinfo_documents = [
(master_doc, 'LegacyLuaAPI', 'Legacy Lua API Documentation',
author, 'LegacyLuaAPI', 'One line description of project.',
(master_doc, 'LeagueLuaAPI', 'League Lua API Documentation',
author, 'LeagueLuaAPI', 'One line description of project.',
'Miscellaneous'),
]

Expand Down
10 changes: 5 additions & 5 deletions constants.rst
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ et.CS_INTERMISSION_START_TIME 36
et.CS_ENDGAME_STATS 37
et.CS_CHARGETIMES 38
et.CS_FILTERCAMS 39
et.CS_LEGACYINFO 40
et.CS_MODINFO 40
et.CS_SVCVAR 41
et.CS_CONFIGNAME 42
et.CS_TEAMRESTRICTIONS 43
Expand Down Expand Up @@ -511,12 +511,12 @@ Lua constants
================= ==================================== ==================
Name Value Description
================= ==================================== ==================
LUA_PATH ./legacy/?.lua; Ease use of the require function
./legacy/lualibs/?.lua; to load scripts
LUA_PATH ./league/?.lua; Ease use of the require function
./league/lualibs/?.lua; to load scripts
fs_homepath/fs_game/?.lua;
fs_homepath/fs_game/lualibs/?.lua
LUA_CPATH ./legacy/lualibs/?.so; Ease use of the require function
fs_homepath/legacy/lualibs/?.so to load libraries
LUA_CPATH ./league/lualibs/?.so; Ease use of the require function
fs_homepath/league/lualibs/?.so to load libraries
LUA_DIRSEP / Directory separator
_VERSION Lua 5.3 Lua version
================= ==================================== ==================
2 changes: 1 addition & 1 deletion cvars.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ Cvars
lua_modules
-----------

Space separated list of lua modules for Legacy mod to load. Modules will be run in the order listed.
Space separated list of lua modules for League mod to load. Modules will be run in the order listed.


lua_allowedmodules
Expand Down
6 changes: 3 additions & 3 deletions database.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
Database
========

Both the Legacy mod and the ET: Legacy engine are built-in with `SQLite3 <https://www.sqlite.org/>`_ database support. The engine allows to execute SQL statement directly in console, while the Legacy mod has access through `LuaSQL <https://keplerproject.github.io/luasql/>`_.
Both the League mod and the ET: Legacy engine are built-in with `SQLite3 <https://www.sqlite.org/>`_ database support. The engine allows to execute SQL statement directly in console, while the League mod has access through `LuaSQL <https://keplerproject.github.io/luasql/>`_.

.. tip:: See the `Database <sample.html#database>`__ sample code for an example of basic database usage.

Expand Down Expand Up @@ -73,9 +73,9 @@ If desired, Lua scripts can also connect to the engine memory database by the fo

conn = assert(env:connect("file::memory:?cache=shared"))

.. Note:: The database is only active when the `db_mode <https://dev.etlegacy.com/projects/etlegacy/wiki/List_of_Cvars#db_-Additional>`_ cvar is set.
.. Note:: The database is only active when the *db_mode* cvar is set.

To save this in memory database to disk use the **saveDB** console command. See also the `db_url <https://dev.etlegacy.com/projects/etlegacy/wiki/List_of_Cvars#db_-Additional>`_ cvar to specify the database path.
To save this in memory database to disk use the **saveDB** console command. See also the *db_url* cvar to specify the database path.


Connection objects
Expand Down
2 changes: 1 addition & 1 deletion fields.rst
Original file line number Diff line number Diff line change
Expand Up @@ -289,7 +289,7 @@ vec3
----

A vec3_t is a 3-element array of numbers, usually used to store and process coordinates in 3D space.
Similarly, in Legacy a vector is an array (table indexed by integers) containing 3 numbers. It can be accessed by::
Similarly, a vector is an array (table indexed by integers) containing 3 numbers. It can be accessed by::

origin = et.gentity_get(entNum, "r.currentOrigin") --a vec3 value
x, y, z = origin[1], origin[2], origin[3]
Expand Down
18 changes: 9 additions & 9 deletions index.rst
Original file line number Diff line number Diff line change
@@ -1,27 +1,27 @@
.. Legacy Lua API documentation master file, created by
.. League Lua API documentation master file, created by
sphinx-quickstart on Tue Sep 13 00:05:27 2016.
You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive.
Legacy Lua API
==============
League Lua API documentation
============================

Welcome to the Legacy Lua API's documentation!
Welcome to the League Lua API's documentation!

The **Legacy mod** is the default mod shipped with `ET: Legacy <http://www.etlegacy.com>`_. It supports server-side modifications via the `Lua <http://www.lua.org/>`_ scripting language, with the Legacy Lua API being the interface for communication between them.
The **League mod** is the default mod shipped with `ET: Legacy <http://www.etlegacy.com>`_. It supports server-side modifications via the `Lua <http://www.lua.org/>`_ scripting language, with the League Lua API being the interface for communication between them.

The embedded **Lua 5.3** interpreter will load user-defined scripts if present in the `legacy` directory. The Lua API provides an "et" library of `function calls <functions.html>`__ that allow access to the server engine, and also provides `callbacks <callbacks.html>`__ so a server side mod may trigger on specific server events.
The embedded **Lua 5.3** interpreter will load user-defined scripts if present in the `league` directory. The Lua API provides an "et" library of `function calls <functions.html>`__ that allow access to the server engine, and also provides `callbacks <callbacks.html>`__ so a server side mod may trigger on specific server events.

In some cases values can be returned to Legacy mod, whenever something is intercepted (i.e. a command) and prevented to be further handled. This way, new commands can easily be defined or existing ones can be altered.
In some cases values can be returned to League mod, whenever something is intercepted (i.e. a command) and prevented to be further handled. This way, new commands can easily be defined or existing ones can be altered.

Through special functions, it is also possible to alter internal structures or entities (manipulate client XP, set and read cvars, remap shaders, etc.).
For example, if a player dies the `et_Obituary( victim, killer, meansOfDeath ) <callbacks.html#et-obituary-target-attacker-meansofdeath>`__ function is executed, and the Lua API allows you to manipulate and control this information.

.. note:: Like qagame, Lua modules are unloaded and reloaded on `map_restart` and map changes, which means that all global variables and other information is lost. Persistent data can be stored in `cvars <functions.html#cvars>`__, external `files <functions.html#filesystem>`__ or `database <database.html>`__.

Legacy's Lua API follows mostly the `ETPub <http://www.etpub.org/>`_ implementation with partial code of the NoQuarter implemention. The ETPub implementation being built to be compatible with `ETPro's Lua <http://wolfwiki.anime.net/index.php/Lua_Mod_API>`_, all scripts written in ETPro's documentation should be valid and more or less compatible with Legacy mod's Lua API.
League's Lua API follows mostly the `ETPub <http://www.etpub.org/>`_ implementation with partial code of the NoQuarter implemention. The ETPub implementation being built to be compatible with `ETPro's Lua <http://wolfwiki.anime.net/index.php/Lua_Mod_API>`_, all scripts written in ETPro's documentation should be valid and more or less compatible with League mod's Lua API.

.. important:: As Legacy uses the newer Lua 5.3, you might want to check the **Incompatibilities with the Previous Version** sections of the `Lua 5.1 <https://www.lua.org/manual/5.1/manual.html#7>`_, `Lua 5.2 <https://www.lua.org/manual/5.2/manual.html#8>`_, and `Lua 5.3 <https://www.lua.org/manual/5.3/manual.html#8>`_ manuals while porting scripts written for other mods.
.. important:: As League uses the newer Lua 5.3, you might want to check the **Incompatibilities with the Previous Version** sections of the `Lua 5.1 <https://www.lua.org/manual/5.1/manual.html#7>`_, `Lua 5.2 <https://www.lua.org/manual/5.2/manual.html#8>`_, and `Lua 5.3 <https://www.lua.org/manual/5.3/manual.html#8>`_ manuals while porting scripts written for other mods.

.. toctree::
:maxdepth: 2
Expand Down
4 changes: 2 additions & 2 deletions make.bat
Original file line number Diff line number Diff line change
Expand Up @@ -129,9 +129,9 @@ if "%1" == "qthelp" (
echo.
echo.Build finished; now you can run "qcollectiongenerator" with the ^
.qhcp project file in %BUILDDIR%/qthelp, like this:
echo.^> qcollectiongenerator %BUILDDIR%\qthelp\LegacyLuaAPI.qhcp
echo.^> qcollectiongenerator %BUILDDIR%\qthelp\LeagueLuaAPI.qhcp
echo.To view the help file:
echo.^> assistant -collectionFile %BUILDDIR%\qthelp\LegacyLuaAPI.ghc
echo.^> assistant -collectionFile %BUILDDIR%\qthelp\LeagueLuaAPI.ghc
goto end
)

Expand Down
4 changes: 2 additions & 2 deletions sample.rst
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
Sample code
===========

.. tip:: If you want to see some ET-specific Lua examples, you can check the `ET Legacy Lua scripts <https://github.com/etlegacy/etlegacy-lua_scripts>`_ repository.
.. tip:: If you want to see some specific Lua examples, you can check the `Lua scripts <https://github.com/etlegacy/etlegacy-lua-scripts>`_ repository.


General
Expand All @@ -12,7 +12,7 @@ General
General example::

--[[
Lua Example ETLegacy
Lua Example
--]]

function et_InitGame(levelTime,randomSeed,restart)
Expand Down

0 comments on commit 762f048

Please sign in to comment.