flatpak-docs icon indicating copy to clipboard operation
flatpak-docs copied to clipboard

Broken link on Build API

Open pedropaulosuzuki opened this issue 1 year ago • 5 comments

On the manifests page, we link to a Github page that simply states "This specification is obsolete and is not recommended for use anymore. For the previous spec, please see the commit history.", without much more explanation.

pedropaulosuzuki avatar Jul 28 '24 22:07 pedropaulosuzuki

Not sure why Build API is separately mentioned. Looking at the old specification, this is very similar to autotools and already covered by what simple can do.

bbhtt avatar Jul 29 '24 02:07 bbhtt

This was well before simple and the point was just to explicitly say what autotools does, in terms of actual commands ran. A lot of project use something autotools-like, so the idea was to specify some common usage.

TingPing avatar Jul 29 '24 17:07 TingPing

So I guess it is better to remove it then

bbhtt avatar Jul 30 '24 02:07 bbhtt

I think its useful information but a broken link helps nobody.

TingPing avatar Jul 30 '24 15:07 TingPing

Basically the information:

flatpak-builder modules are broken up into steps:

  1. Configure This can be meson setup, cmake or ./autogen.sh (controlled by no-autogen and rm-configure) and ./configure plus config-opts

  2. Build ninja/make plus make-args

  3. Install ninja/make install (or install-rule) plus make-install-args and controlled by no-make-install.

(There is also a test step but nobody uses this?)

TingPing avatar Jul 30 '24 15:07 TingPing