Conf.example: Correct grammar and spelling. Shorten some lines. Move a few lines into correct sections. Remove finite liquid reference. Make indentation consistent

1 files changed, 115 insertions, 122 deletions

diff --git a/minetest.conf.example b/minetest.conf.example
index e5e494d9c..95b88c84b 100644
--- a/minetest.conf.example
+++ b/minetest.conf.example
@@ -1,37 +1,37 @@
-# This file is read by default from:
-# ../minetest.conf
-# ../../minetest.conf
-# Any other path can be chosen by passing the path as a parameter
-# to the program, eg. "minetest.exe --config ../minetest.conf.example"
-#
-# By default, all the settings are commented and not functional.
-# Uncomment settings by removing the preceding #.
-#
-# Further documentation:
-# http://wiki.minetest.net/
-#
-# NOTE: This file might not be up-to-date, refer to the
-#       defaultsettings.cpp file for an up-to-date list:
-# https://github.com/minetest/minetest/blob/master/src/defaultsettings.cpp
-#
-# A vim command to convert most of defaultsettings.cpp to conf file format:
-# :'<,'>s/\tsettings->setDefault("\([^"]*\)", "\([^"]*\)");.*/#\1 = \2/g
-# Note: Some of the settings are implemented in Lua
+#    This file is read by default from:
+#    ../minetest.conf
+#    ../../minetest.conf
+#    Any other path can be chosen by passing the path as a parameter
+#    to the program, eg. "minetest.exe --config ../minetest.conf.example".
+
+#    By default, all the settings are commented and not functional.
+#    Uncomment settings by removing the preceding #.
+
+#    Further documentation:
+#    http://wiki.minetest.net/
+
+#    NOTE: This file might not be up-to-date, refer to the
+#    defaultsettings.cpp file for an up-to-date list:
+#    https://github.com/minetest/minetest/blob/master/src/defaultsettings.cpp
+
+#    A vim command to convert most of defaultsettings.cpp to conf file format:
+#    :'<,'>s/\tsettings->setDefault("\([^"]*\)", "\([^"]*\)");.*/#\1 = \2/g
+#    Note: Some of the settings are implemented in Lua.
 
 #
-# Client and server
+#    Client and server
 #
 
-#    Name of player; on a server this is the main admin
+#    Name of player, on a server this is the main admin
 #name =
 
 #
-# Client stuff
+#    Client stuff
 #
 
 #    Port to connect to (UDP)
 #remote_port =
-#    Key mappings
+#    Key mappings.
 #    See http://irrlicht.sourceforge.net/docu/namespaceirr.html#a54da2a0e231901735e3da1b0edf72eb3
 #keymap_forward = KEY_KEY_W
 #keymap_backward = KEY_KEY_S
@@ -62,15 +62,14 @@
 #keymap_quicktune_dec = KEY_NEXT
 #keymap_quicktune_inc = KEY_PRIOR
 
-#    If set to true, you can place blocks at the position (feet + eye level) where you stand
-#    this is helpful when working with nodeboxes
+#    If set to true, you can place blocks at the position (feet + eye level) where you stand.
+#    This is helpful when working with nodeboxes.
 #enable_build_where_you_stand = false
-
-#    Minimum FPS
-#    The amount of rendered stuff is dynamically set according to this
+#    Minimum FPS.
+#    The amount of rendered stuff is dynamically set according to this.
 #wanted_fps = 30
 #    If FPS would go higher than this, limit it by sleeping
-#    to not waste CPU power for no benefit
+#    to not waste CPU power for no benefit.
 #fps_max = 60
 #    Maximum FPS when game is paused
 #pause_fps_max = 20
@@ -83,9 +82,10 @@
 #fullscreen = false
 #fullscreen_bpp = 24
 #    Experimental option, might cause visible spaces between blocks
-#    when set to higher number than 0
+#    when set to higher number than 0.
 #fsaa = 0
 #vsync = false
+#    Field of view in degrees
 #fov = 72
 #    Address to connect to (#blank = start local server)
 #address =
@@ -105,19 +105,19 @@
 #    capacity until an attempt is made to decrease its size by dumping old queue
 #    items.  A value of 0 disables the functionality.
 #liquid_queue_purge_time = 0
-#    Update liquids every .. recommend for finite: 0.2
+#    Liquid update interval in seconds
 #liquid_update = 1.0
-#    Enable nice leaves; disable for speed
+#    Enable transparent leaf textures, disable for speed
 #new_style_leaves = true
 #    Connects glass if supported by node
 #connected_glass = false
-#    Enable smooth lighting with simple ambient occlusion
-#    disable for speed or for different looks.
+#    Enable smooth lighting with simple ambient occlusion.
+#    Disable for speed or for different looks.
 #smooth_lighting = true
 #    Path to texture directory. All textures are first searched from here.
 #texture_path =
 #    Video back-end.
-#    Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl
+#    Possible values: null, software, burningsvideo, direct3d8, direct3d9, opengl.
 #video_driver = opengl
 #    Unobstructed movement without physics, downwards key is keymap_special1
 #free_move = false
@@ -134,20 +134,20 @@
 #    Use a cloud animation for the main menu background
 #menu_clouds = true
 #    Path for screenshots
-#screenshot_path = .
+#screenshot_path =
 #    Amount of view bobbing (0 = no view bobbing, 1.0 = normal, 2.0 = double)
 #view_bobbing_amount = 1.0
 #    Amount of fall bobbing (0 = no fall bobbing, 1.0 = normal, 2.0 = double)
 #fall_bobbing_amount = 0.0
-#    3d support
-#    currently:
-#        "none"       = no 3d output,
-#        "anaglyph"   = cyan/magenta color 3d,
-#        "interlaced" = odd/even line based polarisation screen support,
-#        "topbottom"  = split screen top boton,
-#        "sidebyside" = split screen side by side
+#    3d support.
+#    Currently:
+#        "none"       = no 3d output.
+#        "anaglyph"   = cyan/magenta color 3d.
+#        "interlaced" = odd/even line based polarisation screen support.
+#        "topbottom"  = split screen top/bottom.
+#        "sidebyside" = split screen side by side.
 #3d_mode = none
-#3d_paralax_strength = 0.025
+#3d_parallax_strength = 0.025
 #    In-game chat console background color (R,G,B)
 #console_color = (0,0,0)
 #    In-game chat console background alpha (opaqueness, between 0 and 255)
@@ -165,16 +165,16 @@
 #    Sound settings
 #enable_sound = true
 #sound_volume = 0.7
-#    Whether node texture animations should be desynchronized per MapBlock
+#    Whether node texture animations should be desynchronized per mapblock
 #desynchronize_mapblock_texture_animation = true
 #    Width of the selectionbox's lines (Between 1 and 5)
 #selectionbox_width = 2
-#    Maximum proportion of current window to be used for hotbar
-#    useful if there's something to be displayed right or left of hotbar
+#    Maximum proportion of current window to be used for hotbar.
+#    Useful if there's something to be displayed right or left of hotbar.
 #hud_hotbar_max_width = 1.0
 #    Save the map received by the client on disk
 #enable_local_map_saving = false
-#    Enable highlighting for nodes (disables selectionboxes)
+#    Enable selection highlighting for nodes (disables selectionbox)
 #enable_node_highlighting = false
 #    Texture filtering settings
 #mip_map = false
@@ -194,8 +194,8 @@
 #normalmaps_strength = 0.6
 #    Strength of generated normalmaps
 #normalmaps_smooth = 1
-#    Defines sampling step of texture (0 - 2)
-#    a higher value results in smoother normal maps
+#    Defines sampling step of texture (0 - 2).
+#    A higher value results in smoother normal maps.
 #enable_parallax_occlusion = false
 #    Scale of parallax occlusion effect
 #parallax_occlusion_scale = 0.08
@@ -214,55 +214,61 @@
 #    Enables caching of facedir rotated meshes
 #enable_mesh_cache = true
 #    The time in seconds it takes between repeated
-#    right clicks when holding the right mouse button
+#    right clicks when holding the right mouse button.
 #repeat_rightclick_time = 0.25
 #    Make fog and sky colors depend on daytime (dawn/sunset) and view direction
 #directional_colored_fog = true
-#    Delay showing tooltips, in miliseconds
+#    Delay showing tooltips, stated in milliseconds
 #tooltip_show_delay = 400
 #    Adjust dpi configuration to your screen (Desktop only) e.g. for 4k screens
 #screen_dpi = 72
-
-#    Default timeout for cURL, in milliseconds
-#    Only has an effect if compiled with cURL
+#    Default timeout for cURL, stated in milliseconds.
+#    Only has an effect if compiled with cURL.
 #curl_timeout = 5000
 #    Limits number of parallel HTTP requests. Affects:
-#        Media fetch if server uses remote_media setting
-#        Serverlist download and server announcement
-#        Downloads performed by main menu (e.g. mod manager)
-#    Only has an effect if compiled with cURL
+#        Media fetch if server uses remote_media setting.
+#        Serverlist download and server announcement.
+#        Downloads performed by main menu (e.g. mod manager).
+#    Only has an effect if compiled with cURL.
 #curl_parallel_limit = 8
 #    Maximum time in ms a file download (e.g. a mod download) may take
 #curl_file_download_timeout = 300000
-
 #    Enable usage of remote media server (if provided by server)
 #enable_remote_media_server = true
-
 #    Url to the server list displayed in the Multiplayer Tab
 #serverlist_url = servers.minetest.net
 #    File in client/serverlist/ that contains your favorite servers displayed in the Multiplayer Tab
 #serverlist_file = favoriteservers.txt
-
 #    Whether freetype fonts are used, requires freetype support to be compiled in
 #freetype = true
 #    Path to TrueTypeFont or bitmap
 #font_path = fonts/liberationsans.ttf
 #font_size = 13
-#    Font shadow offset, if 0 then shadow will not be drawn.
+#    Font shadow offset, if 0 then shadow will not be drawn
 #font_shadow = 1
 #    Font shadow alpha (opaqueness, between 0 and 255)
 #font_shadow_alpha = 128
 #mono_font_path = fonts/liberationmono.ttf
 #mono_font_size = 13
-
 #    This font will be used for certain languages
 #fallback_font_path = fonts/DroidSansFallbackFull.ttf
 #fallback_font_size = 13
 #fallback_font_shadow = 1
 #fallback_font_shadow_alpha = 128
+#    Override language. When no value is provided (default) system language is used.
+#    Check "locale" directory for the list of available translations.
+#language =
+#main_menu_script =
+#main_menu_game_mgr = 0
+#main_menu_mod_mgr = 1
+#modstore_download_url = https://forum.minetest.net/media/
+#modstore_listmods_url = https://forum.minetest.net/mmdb/mods/
+#modstore_details_url  = https://forum.minetest.net/mmdb/mod/*/
+#    Makes DirectX work with LuaJIT. Disable if it causes troubles.
+#high_precision_fpu = true
 
 #
-# Server stuff
+#    Server stuff
 #
 
 #    Network port to listen (UDP)
@@ -280,7 +286,7 @@
 #    Automaticaly report to masterserver
 #server_announce = 0
 #    Announce to this masterserver.
-#    If you want to announce your ipv6 address - use  serverlist_url = v6.servers.minetest.net
+#    If you want to announce your ipv6 address - use  serverlist_url = v6.servers.minetest.net.
 #serverlist_url = servers.minetest.net
 #    Default game (default when creating a new world)
 #default_game = minetest
@@ -292,8 +298,8 @@
 #max_users = 15
 #    Set to true to disallow old clients from connecting
 #strict_protocol_version_checking = false
-#    Time in seconds for item entity to live. Default value: 900s
-#    Setting it to -1 disables the feature
+#    Time in seconds for item entity to live. Default value: 900s.
+#    Setting it to -1 disables the feature.
 #item_entity_ttl = 900
 #    Set to true to enable creative mode (unlimited inventory)
 #creative_mode = false
@@ -308,8 +314,8 @@
 #    Available privileges: interact, shout, teleport, settime, privs, ...
 #    See /privs in game for a full list on your server and mod configuration.
 #default_privs = interact, shout
-#    Whether players are shown to clients without any range limit
-#    Deprecated, use the setting player_transfer_distance instead
+#    Whether players are shown to clients without any range limit.
+#    Deprecated, use the setting player_transfer_distance instead.
 #unlimited_player_transfer_distance = true
 #    Defines the maximal player transfer distance in blocks (0 = unlimited)
 #player_transfer_distance = 0
@@ -323,49 +329,49 @@
 #disable_anticheat = false
 #    If true, actions are recorded for rollback
 #enable_rollback_recording = false
-#    handling for deprecated lua api calls
-#        "legacy" = (try to) mimic old behaviour (default for release)
-#        "log"    = mimic and log backtrace of deprecated call (default for debug)
-#        "error"  = abort on usage of deprecated call (suggested for mod developers)
+#    Handling for deprecated lua api calls:
+#        "legacy" = (try to) mimic old behaviour (default for release).
+#        "log"    = mimic and log backtrace of deprecated call (default for debug).
+#        "error"  = abort on usage of deprecated call (suggested for mod developers).
 #deprecated_lua_api_handling = legacy
-
 #    Mod profiler
 #mod_profiling = false
 #    Detailed mod profile data
 #detailed_profiling = false
-
 #    Profiler data print interval. #0 = disable.
 #profiler_print_interval = 0
 #enable_mapgen_debug_info = false
 #    From how far client knows about objects
 #active_object_send_range_blocks = 3
-#    How large area of blocks are subject to the active block stuff (active = objects are loaded and ABMs run)
+#    How large area of blocks are subject to the active block stuff.
+#    Active = objects are loaded and ABMs run.
 #active_block_range = 2
 #    How many blocks are flying in the wire simultaneously per client
 #max_simultaneous_block_sends_per_client = 10
 #    How many blocks are flying in the wire simultaneously per server
 #max_simultaneous_block_sends_server_total = 40
-#    From how far blocks are sent to clients (value * 16 nodes)
+#    From how far blocks are sent to clients, stated in mapblocks (16 nodes)
 #max_block_send_distance = 10
-#    From how far blocks are generated for clients (value * 16 nodes)
+#    From how far blocks are generated for clients, stated in mapblocks (16 nodes)
 #max_block_generate_distance = 6
-#    Number of extra blocks that can be loaded by /clearobjects at once
+#    Number of extra blocks that can be loaded by /clearobjects at once.
 #    This is a trade-off between sqlite transaction overhead and
-#    memory consumption (4096=100MB, as a rule of thumb)
+#    memory consumption (4096=100MB, as a rule of thumb).
 #max_clearobjects_extra_loaded_blocks = 4096
 #    Maximum number of forceloaded blocks
 #max_forceloaded_blocks = 16
 #    Interval of sending time of day to clients
 #time_send_interval = 5
-#    Length of day/night cycle. 72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged
+#    Controls length of day/night cycle.
+#    72=20min, 360=4min, 1=24hour, 0=day/night/whatever stays unchanged.
 #time_speed = 72
-#    Length of year in days for seasons change. With default time_speed 365 days = 5 real days for year.
-#    30 days = 10 real hours
+#    Length of year in days for seasons change.
+#    With default time_speed 365 days = 5 real days for year, 30 days = 10 real hours.
 #year_days = 30
 #server_unload_unused_data_timeout = 29
 #    Maximum number of statically stored objects in a block
 #max_objects_per_block = 49
-#    Interval of saving important changes in the world
+#    Interval of saving important changes in the world, stated in seconds
 #server_map_save_interval = 5.3
 #    http://www.sqlite.org/pragma.html#pragma_synchronous only numeric values: 0 1 2
 #sqlite_synchronous = 2
@@ -376,15 +382,15 @@
 #dedicated_server_step = 0.1
 #    Can be set to true to disable shutting down on invalid world data
 #ignore_world_load_errors = false
-#    Specifies URL from which client fetches media instead of using UDP
+#    Specifies URL from which client fetches media instead of using UDP.
 #    $filename should be accessible from $remote_media$filename via cURL
-#    (obviously, remote_media should end with a slash)
-#    Files that are not present would be fetched the usual way
+#    (obviously, remote_media should end with a slash).
+#    Files that are not present would be fetched the usual way.
 #remote_media =
-#    Level of logging to be written to debug.txt.
-#    0 = none, 1 = errors and debug, 2 = action, 3 = info, 4 = verbose
+#    Level of logging to be written to debug.txt:
+#    0 = none, 1 = errors and debug, 2 = action, 3 = info, 4 = verbose.
 #debug_log_level = 2
-#    Maximum number of blocks that can be queued for loading.
+#    Maximum number of blocks that can be queued for loading
 #emergequeue_limit_total = 256
 #    Maximum number of blocks to be queued that are to be loaded from file.
 #    Set to blank for an appropriate amount to be chosen automatically.
@@ -392,16 +398,23 @@
 #    Maximum number of blocks to be queued that are to be generated.
 #    Set to blank for an appropriate amount to be chosen automatically.
 #emergequeue_limit_generate = 32
-#    Number of emerge threads to use.  Make this field blank, or increase this number, to use multiple threads.
-#    On multiprocessor systems, this will improve mapgen speed greatly, at the cost of slightly buggy caves.
+#    Number of emerge threads to use. Make this field blank, or increase this number
+#    to use multiple threads. On multiprocessor systems, this will improve mapgen speed greatly
+#    at the cost of slightly buggy caves.
 #num_emerge_threads = 1
 #    Maximum number of packets sent per send step, if you have a slow connection
 #    try reducing it, but don't reduce it to a number below double of targeted
-#    client number
+#    client number.
 #max_packets_per_iteration = 1024
+#    Enable/disable IPv6
+#enable_ipv6 = true
+#    Enable/disable running an IPv6 server.  An IPv6 server may be restricted
+#    to IPv6 clients, depending on system configuration.
+#    Ignored if bind_address is set.
+#ipv6_server = false
 
 #
-# Physics stuff
+#    Physics stuff
 #
 
 #movement_acceleration_default = 3
@@ -419,22 +432,23 @@
 #movement_gravity = 9.81
 
 #
-# Mapgen stuff
+#    Mapgen stuff
 #
 
 #    Name of map generator to be used.  Currently supported: v5, v6, v7, singlenode.
 #mg_name = v6
-#    Water surface level of map.
+#    Water surface level of map
 #water_level = 1
-#    Size of chunks to be generated.
+#    Size of chunks to be generated, stated in mapblocks (16 nodes)
 #chunksize = 5
 #    Global map generation attributes.  Currently supported: trees, caves, flat, dungeons, light.
 #    Flags that are not specified in the flag string are not modified from the default.
 #    To explicitly turn off a flag, prepend "no" to the beginning, e.g. nolight.
 #mg_flags = trees, caves
-#    Map generation attributes specific to Mapgen V6.  Currently supported: biomeblend, jungles, mudflow.
+#    Map generation attributes specific to Mapgen V6.
+#    Currently supported: biomeblend, jungles, mudflow.
 #mgv6_spflags = biomeblend, jungles, mudflow
-#    Controls size of deserts and beaches in Mapgen V6.
+#    Controls size of deserts and beaches in Mapgen V6
 #mgv6_freq_desert = 0.45
 #mgv6_freq_beach = 0.15
 
@@ -442,7 +456,6 @@
 #    Noise parameters can be specified as a set of positional values:
 #    Offset, scale, (spread factors), seed offset, number of octaves, persistence, lacunarity.
 #mgv6_np_terrain_base = -4, 20, (250, 250, 250), 82341, 5, 0.6, 2.0
-
 #    Or the new group format can be used instead:
 #mgv6_np_terrain_base = {
 #    offset      = -4
@@ -528,27 +541,7 @@
 #mgv7_np_mountain = 0, 1, (250, 350, 250), 5333, 5, 0.68, 2.0
 #mgv7_np_ridge = 0, 1, (100, 100, 100), 6467, 4, 0.75, 2.0
 
-#    Noise parameters for biome API temperature and humidity.
+#    Noise parameters for biome API temperature and humidity
 #mg_biome_np_heat = 50, 50, (500, 500, 500), 5349, 3, 0.5, 2.0
 #mg_biome_np_humidity = 50, 50, (500, 500, 500), 842, 3, 0.5, 2.0
 
-#    Enable/disable IPv6.
-#enable_ipv6 = true
-#    Enable/disable running an IPv6 server.  An IPv6 server may be restricted
-#    to IPv6 clients, depending on system configuration.
-#    Ignored if bind_address is set.
-#ipv6_server = false
-
-#main_menu_script =
-#main_menu_game_mgr = 0
-#main_menu_mod_mgr = 1
-#modstore_download_url = https://forum.minetest.net/media/
-#modstore_listmods_url = https://forum.minetest.net/mmdb/mods/
-#modstore_details_url  = https://forum.minetest.net/mmdb/mod/*/
-
-#    Makes DirectX work with LuaJIT. Disable if it causes troubles.
-#high_precision_fpu = true
-
-#    Override language. When no value is provided (default) system language is used.
-#    Check "locale" directory for the list of available translations.
-#language =