diff --git a/admin_manual/apps_management.rst b/admin_manual/apps_management.rst index 09bfbdf740b..e2f2036cc25 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 b8b4b4c5e1a..7e2827ca98c 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:: @@ -169,8 +167,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 @@ -178,5 +174,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 9575c25c7b4..77fc89d63a3 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 9c0649d54e4..29f6d4c8125 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 4b63d257cda..9866e71049d 100644 --- a/admin_manual/configuration_user/two_factor-auth.rst +++ b/admin_manual/configuration_user/two_factor-auth.rst @@ -48,8 +48,6 @@ Other 2FA providers may be found in the App Store. Developers can also `implement new two-factor provider apps `_. -.. TODO ON RELEASE: Update version number above on release - Enforcing two-factor authentication ----------------------------------- @@ -57,8 +55,6 @@ By default 2FA is *optional*, hence users are given the choice whether to enable it for their account `under their personal settings `_. Admins may, however, enforce the use of 2FA. -.. TODO ON RELEASE: Update version number above on release - Enforcement is possible system-wide (all users) or for selected groups only. Select groups can also be excluded from 2FA requirements. diff --git a/admin_manual/index.rst b/admin_manual/index.rst index 248119a2f96..a3108dbf2d7 100644 --- a/admin_manual/index.rst +++ b/admin_manual/index.rst @@ -39,5 +39,3 @@ respective manuals: .. _`Nextcloud User Manual`: https://docs.nextcloud.com/server/32/user_manual/en/ .. _`Nextcloud Desktop Client`: https://docs.nextcloud.com/desktop/latest/ - -.. TODO ON RELEASE: Update version number above on release diff --git a/admin_manual/installation/example_ubuntu.rst b/admin_manual/installation/example_ubuntu.rst index b553a291bfb..780a2fcbc34 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 ce915e0edf2..e6582c5e265 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/32/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 1385abaa3b8..65b8146ae41 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/32/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 9e5134037d9..ca35f8b7369 100644 --- a/admin_manual/occ_command.rst +++ b/admin_manual/occ_command.rst @@ -379,8 +379,6 @@ While setting a configuration value, multiple options are available: .. _Appconfig Concepts: https://docs.nextcloud.com/server/32/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 @@ -1152,8 +1150,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 @@ -1245,8 +1241,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 e190604725f..9a4e136b033 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, @@ -43,7 +54,18 @@ html_logo = "../_shared_assets/static/logo-white.png" # 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 = 29 # THIS IS THE OLDEST SUPPORTED VERSION NUMBER diff --git a/developer_manual/basics/logging.rst b/developer_manual/basics/logging.rst index d58566c866b..1c27c09a5cf 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 c8e20b35d90..070b406a5c6 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 796f44d59c2..90d27b493f3 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 f892a775206..a88885d65a6 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 ca21ce22502..63a51df594c 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 befd417bad9..5535ffa3acf 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 bc0bd0077e3..36744b73779 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 0968d5e5319..467a9d55f56 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 67ccf015e59..ee415ab7f14 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/32/admin_manual/desktop/index.html .. _`Developer manual`: https://docs.nextcloud.com/server/32/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 93f7349e61b..2ae3459c1da 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 f7cb574ffa3..1c4b8edd68e 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 47341ea8915..9ce9e41af77 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 8d038296490..4b7d1671bfa 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 f2dec24e1b4..e1b448fd05e 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 f4b3d829a73..c3407ed5b8d 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 88d2bd685c0..b562f937328 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 e4c3f5bd78a..ba32d734298 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 b22ed5f45e0..2e1886178ee 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/32/admin_manual/issues/general_troubleshooting.html#troubleshooting-contacts-calendar .. _Troubleshooting Service Discovery: https://docs.nextcloud.com/server/32/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 23c4ef75f12..cfd153f3ca0 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: