diff --git a/admin_manual/apps_management.rst b/admin_manual/apps_management.rst index e03a4cad3cc..751fffd66c3 100644 --- a/admin_manual/apps_management.rst +++ b/admin_manual/apps_management.rst @@ -31,7 +31,6 @@ have an **Featured**-tag. .. note:: If you would like to develop your own Nextcloud app, you can find out more information in our `developer manual `_. -.. TODO ON RELEASE: Update version number above on release All apps must be licensed under AGPLv3+ or any compatible license. diff --git a/admin_manual/configuration_files/big_file_upload_configuration.rst b/admin_manual/configuration_files/big_file_upload_configuration.rst index 72ca41bd236..5167e022ff7 100644 --- a/admin_manual/configuration_files/big_file_upload_configuration.rst +++ b/admin_manual/configuration_files/big_file_upload_configuration.rst @@ -48,8 +48,6 @@ through WebDAV single file PUT requests or `Chunked file uploads `_ For those, PHP and webserver timeouts are the limiting factor on the upload size. -.. TODO ON RELEASE: Update version number above on release - Adjust these values for your needs. If you see PHP timeouts in your logfiles, increase the timeout values, which are in seconds:: @@ -171,8 +169,6 @@ to the actual file on the Nextcloud servers temporary directory. It is recommend the size of your temp directory accordingly and also ensure that request timeouts are high enough for PHP, webservers or any load balancers involved. -.. TODO ON RELEASE: Update version number above on release - .. tip:: In more recent versions of Nextcloud Server, when uploading to S3 in *Primary Storage* mode, we use S3 `MultipartUpload`. This allows chunked upload streaming of the chunks directly to S3 so that the final MOVE request no longer needs to assemble the final file on the Nextcloud server. This requires your ``memcache.distributed`` to be set to use Redis (or Memcached), otherwise we fall back on the prior behavior which consumes space on the Nextcloud Server for file assembly (as described above). Federated Cloud Sharing @@ -180,5 +176,3 @@ Federated Cloud Sharing If you are using `Federated Cloud Sharing `_ and want to share large files, you can increase the timeout values for requests to the federated servers. Therefore, you can set ``davstorage.request_timeout`` in your ``config.php``. The default value is 30 seconds. - -.. TODO ON RELEASE: Update version number above on release diff --git a/admin_manual/configuration_files/encryption_details.rst b/admin_manual/configuration_files/encryption_details.rst index 540c11506bd..deb6babc4cd 100644 --- a/admin_manual/configuration_files/encryption_details.rst +++ b/admin_manual/configuration_files/encryption_details.rst @@ -356,5 +356,3 @@ Sources - `Sourcecode: Generation of the File Key `_ - `Sourcecode: Generation of the Initialization Vector `_ - `Sourcecode: Generation of a Key Pair `_ - -.. TODO ON RELEASE: Update version number above on release diff --git a/admin_manual/configuration_files/file_sharing_configuration.rst b/admin_manual/configuration_files/file_sharing_configuration.rst index e42ec09314e..550a7a78558 100644 --- a/admin_manual/configuration_files/file_sharing_configuration.rst +++ b/admin_manual/configuration_files/file_sharing_configuration.rst @@ -100,8 +100,6 @@ forcing them. .. note:: There are more sharing options on config.php level available: `Configuration Parameters `_ -.. TODO ON RELEASE: Update version number above on release - .. _transfer_userfiles_label: Advanced settings @@ -178,8 +176,6 @@ reference.) Users may also transfer files or folders selectively by themselves. See `user documentation `_ for details. -.. TODO ON RELEASE: Update version number above on release - Creating persistent file Shares ------------------------------- diff --git a/admin_manual/configuration_user/two_factor-auth.rst b/admin_manual/configuration_user/two_factor-auth.rst index 46861aaf287..7312f1a00a3 100644 --- a/admin_manual/configuration_user/two_factor-auth.rst +++ b/admin_manual/configuration_user/two_factor-auth.rst @@ -43,15 +43,11 @@ types of factors. Three providers are automatically installed (but may need to b Other 2FA providers may be found in the App Store. -.. TODO ON RELEASE: Update version number above on release - .. figure:: ../images/2fa-app-install.png Developers can also `implement new two-factor provider apps `_. -.. TODO ON RELEASE: Update version number above on release - Enforcing two-factor authentication ----------------------------------- diff --git a/admin_manual/index.rst b/admin_manual/index.rst index 85af0a1d253..8cb2e40c416 100644 --- a/admin_manual/index.rst +++ b/admin_manual/index.rst @@ -33,8 +33,6 @@ For documentation on development topics, see: - The individual repositories on GitHub within `the @nextcloud organization `_ - `Nextcloud Development Manual `_ -.. TODO ON RELEASE: Update version number above on release - Core Components --------------- diff --git a/admin_manual/installation/example_ubuntu.rst b/admin_manual/installation/example_ubuntu.rst index af0b0809272..b5e7ae32162 100644 --- a/admin_manual/installation/example_ubuntu.rst +++ b/admin_manual/installation/example_ubuntu.rst @@ -16,8 +16,6 @@ following commands in a terminal:: If you are planning on running additional apps, keep in mind that they might require additional packages. See `Prerequisites for manual installation `_ for details. -.. TODO ON RELEASE: Update version number above on release - Now you need to create a database user and the database itself by using the MySQL command line interface. The database tables will be created by Nextcloud when you login for the first time. diff --git a/admin_manual/installation/harden_server.rst b/admin_manual/installation/harden_server.rst index 4b24fcb9aea..d884534e70a 100644 --- a/admin_manual/installation/harden_server.rst +++ b/admin_manual/installation/harden_server.rst @@ -305,8 +305,6 @@ Depending on your server setup, these are the possible connections: .. _optional (config): https://docs.nextcloud.com/server/latest/admin_manual/configuration_server/config_sample_php_parameters.html#has-internet-connection .. _detailed field list: https://github.com/nextcloud/survey_client -.. TODO ON RELEASE: Update version number above on release - Setup fail2ban -------------- diff --git a/admin_manual/issues/general_troubleshooting.rst b/admin_manual/issues/general_troubleshooting.rst index 93b4acf4375..bb71b685ec1 100644 --- a/admin_manual/issues/general_troubleshooting.rst +++ b/admin_manual/issues/general_troubleshooting.rst @@ -33,8 +33,6 @@ configuration report with the :ref:`occ config command .. _FAQ page: https://help.nextcloud.com/t/how-to-faq-wiki .. _bugtracker: https://docs.nextcloud.com/server/latest/developer_manual/prologue/bugtracker/index.html -.. TODO ON RELEASE: Update version number above on release - General troubleshooting ----------------------- @@ -415,8 +413,6 @@ does not match the actual data stored in the user's ``data/$userId/files`` direc Metadata, versions, trashbin and encryption keys are not counted in the used space above. Please refer to the `quota documentation `_ for details. -.. TODO ON RELEASE: Update version number above on release - Running the following command can help fix the sizes and quota for a given user:: sudo -E -u www-data php occ files:scan -vvv diff --git a/admin_manual/occ_command.rst b/admin_manual/occ_command.rst index 40117bb3907..7826cefa53d 100644 --- a/admin_manual/occ_command.rst +++ b/admin_manual/occ_command.rst @@ -375,8 +375,6 @@ While setting a configuration value, multiple options are available: .. _Appconfig Concepts: https://docs.nextcloud.com/server/latest/developer_manual/digging_deeper/config/appconfig.html#concept-overview -.. TODO ON RELEASE: Update version number above on release - You can list all configuration values with one command:: sudo -E -u www-data php occ config:list @@ -1150,8 +1148,6 @@ The command line option ``--transfer-incoming-shares`` overwrites the config.php Users may also transfer files or folders selectively by themselves. See `user documentation `_ for details. -.. TODO ON RELEASE: Update version number above on release - .. _occ_files_windows_filenames: Toggle Windows compatibility @@ -1243,8 +1239,6 @@ Verify your app:: When it returns nothing, your app is signed correctly. When it returns a message then there is an error. See `Code Signing `_ in the Developer manual for more detailed information. -.. TODO ON RELEASE: Update version number above on release - ``integrity:sign-core`` is for Nextcloud core developers only. See :doc:`../issues/code_signing` to learn more. diff --git a/conf.py b/conf.py index 0d88c43c270..deec64e0ace 100644 --- a/conf.py +++ b/conf.py @@ -31,6 +31,17 @@ # Can be overridden via DOCS_RELEASE env var (used for PDF builds to show the actual version number) release = os.environ.get('DOCS_RELEASE', version) +# Ensure release is either "latest", or a digit (for stable versions) +if not (release == 'latest' or release.isdigit()): + raise ValueError("Invalid release version: %s. Must be 'latest' or a digit." % release) + +# Print the version being built in a clear way in the logs +width = 60 +msg = " Building documentation for version: %s " % release +print("\n\n" + "#" * width) +print("#" + msg.center(width - 2, "#") + "#") +print("#" * width + "\n\n") + # RTD theme options html_theme_options = { 'logo_only': True, @@ -46,7 +57,18 @@ html_copy_source = False # substitutions go here -rst_epilog = '.. |version| replace:: %s' % version +rst_epilog = """ +.. |version| replace:: %s +""" % (release) + +# Replace hardcoded /latest/ URLs in all .rst source files with the actual release +def replace_latest(app, docname, source): + if release != 'latest': + source[0] = source[0].replace('/server/latest/', '/server/%s/' % release) + +def setup(app): + app.connect('source-read', replace_latest) + # building the versions list version_start = 31 # THIS IS THE OLDEST SUPPORTED VERSION NUMBER diff --git a/developer_manual/basics/logging.rst b/developer_manual/basics/logging.rst index 8dac7fbde4e..562adc98c1a 100644 --- a/developer_manual/basics/logging.rst +++ b/developer_manual/basics/logging.rst @@ -50,8 +50,6 @@ who changed the password of an item or made it public, the `admin audit log `_ is the correct place. -.. TODO ON RELEASE: Update version number above on release - You can easily add a log by simply emitting an ``OCP\Log\Audit\CriticalActionPerformedEvent`` event: .. code-block:: php diff --git a/developer_manual/basics/setting.rst b/developer_manual/basics/setting.rst index 5e15bbb9f12..3a93091b30e 100644 --- a/developer_manual/basics/setting.rst +++ b/developer_manual/basics/setting.rst @@ -115,8 +115,6 @@ This is a feature that needs to be enabled for each admin setting class. To do so, the setting class needs to implement `IDelegatedSettings` instead of `ISettings` and implement two additional methods. -.. TODO ON RELEASE: Update version number above on release - .. code-block:: php `_. -.. TODO ON RELEASE: Update version number above on release - Create a new Federated Cloud Share ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/developer_manual/client_apis/OCS/ocs-taskprocessing-api.rst b/developer_manual/client_apis/OCS/ocs-taskprocessing-api.rst index a2e1cd9e9df..0715166523d 100644 --- a/developer_manual/client_apis/OCS/ocs-taskprocessing-api.rst +++ b/developer_manual/client_apis/OCS/ocs-taskprocessing-api.rst @@ -9,5 +9,3 @@ OCS TaskProcessing API The OCS Task processing API allows you to run task processing tasks, like prompting large language models implemented by apps using :ref:`the backend Task Processing API`. See the relevant `OpenAPI docs `_. - -.. TODO ON RELEASE: Update version number above on release diff --git a/developer_manual/exapp_development/faq/DockerSocketProxy.rst b/developer_manual/exapp_development/faq/DockerSocketProxy.rst index fc1f4fe7b8b..ada4e1af7a4 100644 --- a/developer_manual/exapp_development/faq/DockerSocketProxy.rst +++ b/developer_manual/exapp_development/faq/DockerSocketProxy.rst @@ -30,8 +30,6 @@ AppAPI automatically creates the default Deploy daemon configuration for Nextclo See `Nextcloud in Docker AIO (all-in-one) `_ for more details. -.. TODO ON RELEASE: Update version number above on release - .. note:: Nextcloud AIO is not limited to its default Deploy daemon. diff --git a/developer_manual/exapp_development/faq/Troubleshooting.rst b/developer_manual/exapp_development/faq/Troubleshooting.rst index 432d8b7ab38..01188a532e5 100644 --- a/developer_manual/exapp_development/faq/Troubleshooting.rst +++ b/developer_manual/exapp_development/faq/Troubleshooting.rst @@ -30,8 +30,6 @@ ExApp deployment issues The deployment issues questions are covered in the `Test Deploy `_ section of the administration guide. Generally speaking, there are three steps to find the proper error message to understand the problem: -.. TODO ON RELEASE: Update version number above on release - 1. Check Nextcloud logs 2. Check ExApp container logs (available only if ExApp container is created and/or running) 3. Check Deploy daemon host logs (``journalctl -u docker.service``) diff --git a/developer_manual/exapp_development/tech_details/Translations.rst b/developer_manual/exapp_development/tech_details/Translations.rst index 1d9a2f27200..a0ee03a0f94 100644 --- a/developer_manual/exapp_development/tech_details/Translations.rst +++ b/developer_manual/exapp_development/tech_details/Translations.rst @@ -47,8 +47,6 @@ For the ``manual-install`` type, an administrator will have to manually extract (e.g. ``/path/to/apps-writable//l10n/*.(js|json)``). This will allow the server to access the ExApp's strings with translations. -.. TODO ON RELEASE: Update version number above on release - .. note:: Only the ``l10n`` folder must be present on the server side; ``appinfo/info.xml`` could lead to misdetection by the server as a PHP app folder. diff --git a/developer_manual/exapp_development/tech_details/api/logging.rst b/developer_manual/exapp_development/tech_details/api/logging.rst index 9464a470a3d..ad8aa31d3e6 100644 --- a/developer_manual/exapp_development/tech_details/api/logging.rst +++ b/developer_manual/exapp_development/tech_details/api/logging.rst @@ -27,8 +27,6 @@ Request data The possible values of ``log_lvl`` are described here: `Nextcloud Log level `_ -.. TODO ON RELEASE: Update version number above on release - Response data ************* diff --git a/developer_manual/getting_started/devenv.rst b/developer_manual/getting_started/devenv.rst index 7d9fb281efc..db0e93f9248 100644 --- a/developer_manual/getting_started/devenv.rst +++ b/developer_manual/getting_started/devenv.rst @@ -18,8 +18,6 @@ Set up Web server and database First `set up your Web server and database `_ (**Section**: Manual Installation - Prerequisites). -.. TODO ON RELEASE: Update version number above on release - Get the source -------------- @@ -28,8 +26,6 @@ There are two ways to obtain Nextcloud sources: * Using the `stable version `_ * Using the development version from `GitHub`_ which will be explained below. -.. TODO ON RELEASE: Update version number above on release - To check out the source from `GitHub`_ you will need to install Git (see `Setting up Git `_ from the GitHub help) Gather information about server setup diff --git a/user_manual/desktop/index.rst b/user_manual/desktop/index.rst index 5d20c9b54f3..a68b692aea8 100644 --- a/user_manual/desktop/index.rst +++ b/user_manual/desktop/index.rst @@ -29,5 +29,3 @@ You can find additional information here: .. _`Admin manual`: https://docs.nextcloud.com/server/latest/admin_manual/desktop/index.html .. _`Developer manual`: https://docs.nextcloud.com/server/latest/developer_manual/desktop/index.html - -.. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/external_storage/external_storage.rst b/user_manual/external_storage/external_storage.rst index da9a0810319..7af7a6757bf 100644 --- a/user_manual/external_storage/external_storage.rst +++ b/user_manual/external_storage/external_storage.rst @@ -8,5 +8,3 @@ in Nextcloud. Your Nextcloud server administrator controls which of these are available to you. Please see `Configuring External Storage (GUI) `_ in the Nextcloud Administrator's manual for configuration how-tos and examples. - -.. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/files/access_webdav.rst b/user_manual/files/access_webdav.rst index 1aab65124d7..f181c132ccf 100644 --- a/user_manual/files/access_webdav.rst +++ b/user_manual/files/access_webdav.rst @@ -224,8 +224,6 @@ Accessing files using macOS .. note:: The macOS Finder suffers from a `series of implementation problems `_ and should only be used if the Nextcloud server runs on **Apache** and **mod_php**, or **Nginx 1.3.8+**. Alternative macOS-compatible clients capable of accessing WebDAV shares include open source apps like `Cyberduck `_ (see instructions `here `_) and `Filezilla `_. Commercial clients include `Mountain Duck `_, `Forklift `_, `Transmit `_, and `Commander One `_. -.. TODO ON RELEASE: Update version number above on release - To access files through the macOS Finder: #. From the Finder's top menu bar, choose **Go > Connect to Server…**: diff --git a/user_manual/files/deleted_file_management.rst b/user_manual/files/deleted_file_management.rst index 8684a76147a..6eb13a69e49 100644 --- a/user_manual/files/deleted_file_management.rst +++ b/user_manual/files/deleted_file_management.rst @@ -57,5 +57,3 @@ until the space limit is met again. .. note:: Your administrator may have configured the trash bin retention period to override the storage space management. See `admin documentation `_ for more details. - -.. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/files/encrypting_files.rst b/user_manual/files/encrypting_files.rst index 50398945a2d..2cc3d38ea5c 100644 --- a/user_manual/files/encrypting_files.rst +++ b/user_manual/files/encrypting_files.rst @@ -37,8 +37,6 @@ The only way to disable encryption is to run the `"decrypt all" `_ script, which decrypts all files and disables encryption. -.. TODO ON RELEASE: Update version number above on release - Is it possible to disable encryption with the recovery key? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -46,8 +44,6 @@ Yes, *if* every user uses the `file recovery key `_, `"decrypt all" `_ will use it to decrypt all files. -.. TODO ON RELEASE: Update version number above on release - Can encryption be disabled without the user's password? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -56,8 +52,6 @@ If you don't have the users password or `file recovery key then there is no way to decrypt all files. What's more, running it on login would be dangerous, because you would most likely run into timeouts. -.. TODO ON RELEASE: Update version number above on release - Is it planned to move this to the next user login or a background job? ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff --git a/user_manual/files/large_file_upload.rst b/user_manual/files/large_file_upload.rst index cf39c1c2fe7..bce6c1efa86 100644 --- a/user_manual/files/large_file_upload.rst +++ b/user_manual/files/large_file_upload.rst @@ -11,5 +11,3 @@ Modifying certain Nextcloud variables requires administrative access. If you req * Refer to the section in the `Administration Documentation `_ that describes how to manage file upload size limits. - -.. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/files/quota.rst b/user_manual/files/quota.rst index 93eeda0923f..69c95b70a37 100644 --- a/user_manual/files/quota.rst +++ b/user_manual/files/quota.rst @@ -31,8 +31,6 @@ total is below 50%. .. note:: Your administrator may have configured the trash bin retention period to override the storage space management. See `administrator documentation `_ for more details. -.. TODO ON RELEASE: Update version number above on release - When version control is enabled, the older file versions are not counted against quotas. diff --git a/user_manual/files/sharing.rst b/user_manual/files/sharing.rst index ba960b930a6..c4b8340c77b 100644 --- a/user_manual/files/sharing.rst +++ b/user_manual/files/sharing.rst @@ -14,8 +14,6 @@ Nextcloud users can share files and folders. Possible targets are: .. note:: Some options may not be available due to administrative configuration. See `administrator documentation `__ for details. -.. TODO ON RELEASE: Update version number above on release - Public link shares ------------------ diff --git a/user_manual/files/transfer_ownership.rst b/user_manual/files/transfer_ownership.rst index 97cc75c2490..df278aef99f 100644 --- a/user_manual/files/transfer_ownership.rst +++ b/user_manual/files/transfer_ownership.rst @@ -15,8 +15,6 @@ ownerships of those transferred files/folders will also be transferred. .. note:: The username autocompletion or listing may be limited due to administrative visibility configuration. See `administrator documentation `_ for details. -.. TODO ON RELEASE: Update version number above on release - #. The target user receives a notification where they are being asked whether to accept or reject the incoming transfer. diff --git a/user_manual/groupware/sync_ios.rst b/user_manual/groupware/sync_ios.rst index be23255f195..46165d7a12a 100644 --- a/user_manual/groupware/sync_ios.rst +++ b/user_manual/groupware/sync_ios.rst @@ -55,5 +55,3 @@ If it's still not working, have a look at `Troubleshooting Contacts & Calendar`_ .. _Troubleshooting Contacts & Calendar: https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html#troubleshooting-contacts-calendar .. _Troubleshooting Service Discovery: https://docs.nextcloud.com/server/latest/admin_manual/issues/general_troubleshooting.html#service-discovery - -.. TODO ON RELEASE: Update version number above on release diff --git a/user_manual/groupware/sync_kde.rst b/user_manual/groupware/sync_kde.rst index a3b42eb4fb1..488f4261ce2 100644 --- a/user_manual/groupware/sync_kde.rst +++ b/user_manual/groupware/sync_kde.rst @@ -30,8 +30,6 @@ In KOrganizer and Kalendar: 3. Enter your username. As password, you need to generate an app-password/token (`Learn more `_): -.. TODO ON RELEASE: Update version number above on release - .. image:: ../images/korganizer_credentials.png 4. Choose ``Nextcloud`` as Groupware server option: