libcamera: Replace outdated git URLs

27352 diff mbox series

The libcamera main repository has moved to gitlab.freedesktop.org a
while ago. https://git.libcamera.org/libcamera/libcamera/ was kept as a
mirror, and has now started to redirecto to gitlab.freedesktop.org due
to the Gitolite server being decommissioned.

This causes several problems:  URLs to files now redirect to
non-existing pages, as Gitolite and Gitlab use different URL syntaxes,
and "git clone" now prints a redirection warning. Even for URLs that
redirect properly, following links from the libcamera documentation
causes unnecessary redirections.

There is no need to keep using the git.libcamera.org host name, as
libcamera will stay on gitlab.freedesktop.org for the foreseable future.
Fix the issues by replacing git.libcamera.org URLs with their
gitlab.freedesktop.org equivalent.

Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
---
You may notice that some repository URLs now end with a '/', for
instance in

-  $ git clone https://git.libcamera.org/libcamera/libcamera.git
+  $ git clone https://gitlab.freedesktop.org/camera/libcamera.git/

or in

-# https://git.libcamera.org/libcamera/simple-cam.git
+# https://gitlab.freedesktop.org/camera/simple-cam.git/

When cloning a Gitlab URL that does not end with '.git', Gitlab
redirects to a URL that ends with '.git/'. I have therefore decided to
standardize repository URLs with a trailing '/', even if URLs without it
work equally fine.
---
 Documentation/contributing.rst                 | 11 ++++-------
 Documentation/guides/application-developer.rst |  4 ++--
 Documentation/runtime_configuration.rst        |  4 ++--
 README.rst                                     |  2 +-
 REUSE.toml                                     |  2 +-
 src/py/examples/simple-cam.py                  |  2 +-
 6 files changed, 11 insertions(+), 14 deletions(-)


base-commit: 32b0d940baaf182a9d01d4833e30bd340d4dc918

Quoting Laurent Pinchart (2026-07-08 22:55:57)
> The libcamera main repository has moved to gitlab.freedesktop.org a
> while ago. https://git.libcamera.org/libcamera/libcamera/ was kept as a
> mirror, and has now started to redirecto to gitlab.freedesktop.org due
> to the Gitolite server being decommissioned.
> 
> This causes several problems:  URLs to files now redirect to
> non-existing pages, as Gitolite and Gitlab use different URL syntaxes,
> and "git clone" now prints a redirection warning. Even for URLs that
> redirect properly, following links from the libcamera documentation
> causes unnecessary redirections.
> 
> There is no need to keep using the git.libcamera.org host name, as
> libcamera will stay on gitlab.freedesktop.org for the foreseable future.
> Fix the issues by replacing git.libcamera.org URLs with their
> gitlab.freedesktop.org equivalent.
> 
> Signed-off-by: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
> ---
> You may notice that some repository URLs now end with a '/', for
> instance in
> 
> -  $ git clone https://git.libcamera.org/libcamera/libcamera.git
> +  $ git clone https://gitlab.freedesktop.org/camera/libcamera.git/
> 
> or in
> 
> -# https://git.libcamera.org/libcamera/simple-cam.git
> +# https://gitlab.freedesktop.org/camera/simple-cam.git/
> 
> When cloning a Gitlab URL that does not end with '.git', Gitlab
> redirects to a URL that ends with '.git/'. I have therefore decided to
> standardize repository URLs with a trailing '/', even if URLs without it
> work equally fine.

aha, that's what I just also discovered from the buildroot patch.

However - if you open the web interface and get the URL they report
without a slash:

clicking the 'code' button and clone with https reports:

  https://gitlab.freedesktop.org/camera/simple-cam.git

Cloning without the trailing slash doesn't redirect:

kbingham@Monstersaurus:/tmp$ git clone https://gitlab.freedesktop.org/camera/simple-cam.git
Cloning into 'simple-cam'...
remote: Enumerating objects: 112, done.
remote: Total 112 (delta 0), reused 0 (delta 0), pack-reused 112 (from 1)
Receiving objects: 100% (112/112), 23.34 KiB | 23.34 MiB/s, done.
Resolving deltas: 100% (56/56), done.


So I feel like the trailing slash is a bit superfluous and probably a
bug/nuance in their redirection more than anything.

Personally I wouldn't add them, but whatever you prefer.


Reviewed-by: Kieran Bingham <kieran.bingham@ideasonboard.com>





> ---
>  Documentation/contributing.rst                 | 11 ++++-------
>  Documentation/guides/application-developer.rst |  4 ++--
>  Documentation/runtime_configuration.rst        |  4 ++--
>  README.rst                                     |  2 +-
>  REUSE.toml                                     |  2 +-
>  src/py/examples/simple-cam.py                  |  2 +-
>  6 files changed, 11 insertions(+), 14 deletions(-)
> 
> diff --git a/Documentation/contributing.rst b/Documentation/contributing.rst
> index 495bfb3196b3..6942ac8ebb4f 100644
> --- a/Documentation/contributing.rst
> +++ b/Documentation/contributing.rst
> @@ -58,17 +58,14 @@ In the foreseeable future, the following applies:
>            Following semantic versioning as documented at https://semver.org/
>  
>  
> -The source code is available from the project's `git tree`_.
> +The source code is available from the project's `git tree`_, hosted by
> +Freedesktop.
>  
>  .. code-block:: shell
>  
> -  $ git clone https://git.libcamera.org/libcamera/libcamera.git
> +  $ git clone https://gitlab.freedesktop.org/camera/libcamera.git/
>  
> -.. _git tree: https://git.libcamera.org/libcamera/libcamera.git/
> -
> -A development mirror is also hosted on `Freedesktop`_.
> -
> -.. _Freedesktop: https://gitlab.freedesktop.org/camera/libcamera
> +.. _git tree: https://gitlab.freedesktop.org/camera/libcamera/
>  
>  Freedesktop also provides our CI and `testing pipeline`_.
>  
> diff --git a/Documentation/guides/application-developer.rst b/Documentation/guides/application-developer.rst
> index a9620ca8620f..bb9a12ba9f5e 100644
> --- a/Documentation/guides/application-developer.rst
> +++ b/Documentation/guides/application-developer.rst
> @@ -475,7 +475,7 @@ instance. An example of how to write image data to disk is available in the
>  `FileSink class`_ which is a part of the ``cam`` utility application in the
>  libcamera repository.
>  
> -.. _FileSink class: https://git.libcamera.org/libcamera/libcamera.git/tree/src/apps/cam/file_sink.cpp
> +.. _FileSink class: https://gitlab.freedesktop.org/camera/libcamera/-/blob/master/src/apps/cam/file_sink.cpp
>  
>  With the handling of this request completed, it is possible to re-use the
>  request and the associated buffers and re-queue it to the camera
> @@ -562,7 +562,7 @@ install the ``pkg-config`` tool to correctly identify the libcamera.so object
>  install location in the system.
>  
>  .. _Meson build system: https://mesonbuild.com/
> -.. _git repository: https://git.libcamera.org/libcamera/libcamera.git/
> +.. _git repository: https://gitlab.freedesktop.org/camera/libcamera.git/
>  
>  Dependencies
>  ~~~~~~~~~~~~
> diff --git a/Documentation/runtime_configuration.rst b/Documentation/runtime_configuration.rst
> index 2cdffb335a66..a71b715a1724 100644
> --- a/Documentation/runtime_configuration.rst
> +++ b/Documentation/runtime_configuration.rst
> @@ -256,7 +256,7 @@ Log categories
>  
>  Every category represents a specific area of the libcamera codebase,
>  the names can be located within the source code, for example:
> -`src/libcamera/camera_manager.cpp <https://git.libcamera.org/libcamera/libcamera.git/tree/src/libcamera/camera_manager.cpp#n35>`__
> +`src/libcamera/camera_manager.cpp <https://gitlab.freedesktop.org/camera/libcamera/-/blob/master/src/libcamera/camera_manager.cpp#L38>`__
>  
>  .. code:: cpp
>  
> @@ -287,7 +287,7 @@ usually contain tuning parameters for the algorithms, in JSON format.
>  The ``LIBCAMERA_IPA_CONFIG_PATH`` variable can be used to specify custom
>  storage locations to search for those configuration files.
>  
> -`Examples <https://git.libcamera.org/libcamera/libcamera.git/tree/src/ipa/rpi/vc4/data>`__
> +`Examples <https://gitlab.freedesktop.org/camera/libcamera/-/blob/master/src/ipa/rpi/vc4/data>`__
>  
>  IPA module
>  ~~~~~~~~~~
> diff --git a/README.rst b/README.rst
> index 56b2e0956e36..33b910c6ef3d 100644
> --- a/README.rst
> +++ b/README.rst
> @@ -29,7 +29,7 @@ To fetch the sources, build and install:
>  
>  .. code::
>  
> -  git clone https://git.libcamera.org/libcamera/libcamera.git
> +  git clone https://gitlab.freedesktop.org/camera/libcamera.git/
>    cd libcamera
>    meson setup build
>    ninja -C build install
> diff --git a/REUSE.toml b/REUSE.toml
> index e7509ac41532..4783811b43e2 100644
> --- a/REUSE.toml
> +++ b/REUSE.toml
> @@ -1,7 +1,7 @@
>  version = 1
>  SPDX-PackageName = "libcamera"
>  SPDX-PackageSupplier = "Laurent Pinchart <laurent.pinchart@ideasonboard.com>"
> -SPDX-PackageDownloadLocation = "https://git.libcamera.org/libcamera/libcamera.git/"
> +SPDX-PackageDownloadLocation = "https://gitlab.freedesktop.org/camera/libcamera/"
>  
>  [[annotations]]
>  path = [
> diff --git a/src/py/examples/simple-cam.py b/src/py/examples/simple-cam.py
> index 1cd1019da955..78cfae57ad0a 100755
> --- a/src/py/examples/simple-cam.py
> +++ b/src/py/examples/simple-cam.py
> @@ -6,7 +6,7 @@
>  # A simple libcamera capture example
>  #
>  # This is a python version of simple-cam from:
> -# https://git.libcamera.org/libcamera/simple-cam.git
> +# https://gitlab.freedesktop.org/camera/simple-cam.git/
>  #
>  # \todo Move to simple-cam repository when the Python API has stabilized more
>  
> 
> base-commit: 32b0d940baaf182a9d01d4833e30bd340d4dc918
> -- 
> Regards,
> 
> Laurent Pinchart
>