Skip to content

Commit 7607abe

Browse files
committed
Link to snapshot as 0.17.0.snapshot, also link to it from main page
1 parent d0e16f2 commit 7607abe

5 files changed

Lines changed: 44 additions & 18 deletions

File tree

_config.yml

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,8 @@ show_downloads: true
2020
# our custom theme variables:
2121
pasdoc:
2222
repository_url: https://github.com/pasdoc/pasdoc
23-
download_version: 0.16.0
23+
stable_download_version: 0.16.0
24+
unstable_download_version: 0.17.0.snapshot
2425
main_url: index
2526

2627
# for highlighting in code blocks, see https://github.com/asciidoctor/jekyll-asciidoc

src/DevelopmentSnapshots.asciidoc

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,17 @@ The files available there are automatically build from the latest source (using
88

99
In particular, download latest builds for:
1010

11-
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.16.0-linux-x86_64.tar.gz[Linux (x86_64)]
12-
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.16.0-linux-arm.tar.gz[Linux (Arm, 32-bit) (Raspberry Pi)]
13-
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.16.0-linux-aarch64.tar.gz[Linux (Aarch64, 64-bit) (Raspberry Pi, PineTab2)]
14-
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.16.0-win64.zip[Windows (x86_64)]
15-
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.16.0-darwin-x86_64.zip[macOS (x86_64)]
11+
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.17.0.snapshot-linux-x86_64.tar.gz[Linux (x86_64)]
12+
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.17.0.snapshot-linux-arm.tar.gz[Linux (Arm, 32-bit) (Raspberry Pi)]
13+
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.17.0.snapshot-linux-aarch64.tar.gz[Linux (Aarch64, 64-bit) (Raspberry Pi, PineTab2)]
14+
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.17.0.snapshot-win64.zip[Windows (x86_64)]
15+
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.17.0.snapshot-darwin-x86_64.zip[macOS (x86_64)]
16+
* https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-0.17.0.snapshot-darwin-x86_64.zip[macOS (Aarch64)]
1617
1718
These snapshots look like regular link:index[PasDoc] releases, but are actually compiled automatically from https://github.com/pasdoc/pasdoc[current GitHub code].
1819

19-
Don't be confused by their version numbers. As version, they show the
20-
number of last released link:index[PasDoc] version, but in fact they
21-
are just snapshots. When reporting bugs for them, please mention that
22-
you used the snapshots, and mention their date (or Git revision).
20+
Note: Since these "snapshot" versions change frequently, when reporting bugs please mention not only the version number (`0.17.0.snapshot`) but also the date when you downloaded them or https://github.com/pasdoc/pasdoc[last GIT commit hash] used to build them.
2321

24-
Remember that you can always download and compile current pasdoc sources
22+
Note: You can always download and compile current pasdoc sources
2523
yourself. See the GIT instructions link:index[on the main page] and
2624
see link:CompilingPasDoc[CompilingPasDoc].

src/PhpOutput.asciidoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
:doctitle: PHP Output
22

3-
**This is new feature in upcoming PasDoc 0.17.0. Not yet available in stable 0.16.0.**
3+
**This is a new feature, not yet available in stable PasDoc version 0.16.0.**
44

55
PHP output of PasDoc generates a map that can be used to find identifiers in your HTML documentation.
66

src/ReleaseMaking.asciidoc

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,16 @@
22

33
Release making process:
44

5-
## Change version number
5+
## Change version number to next stable
66

77
* Change version of all packages in pasdoc/source/packages/ dir. Right now this means changing
88
** .../packages/lazarus/pasdoc_package.lpk
99
** all Delphi packages
1010
* change VERSION in pasdoc/Makefile
1111
* change PASDOC_VERSION and PASDOC_DATE in pasdoc/source/components/PasDoc_Versions.pas
1212
13+
Make last version number _even_ to signify stable release, like `1.2.4`.
14+
1315
## [[write-changelog-entry]] Write ChangeLog entry
1416

1517
Make sure you have nice entry in https://github.com/pasdoc/pasdoc/blob/master/ChangeLog.md file in pasdoc sources.
@@ -105,3 +107,11 @@ changing the project's description:
105107
* on https://github.com/pasdoc/pasdoc/[GitHub]
106108
* on https://sourceforge.net/projects/pasdoc/[SF project page]
107109
* on http://wiki.lazarus.freepascal.org/Projects_using_Lazarus#PasDoc[Lazarus wiki "Projects Using Lazarus" page]
110+
111+
## Change version number to next UNstable
112+
113+
Repeat the steps from _"Change version number to next stable"_, but :
114+
115+
- Make last version number _odd_ to signify unstable release and add `.snapshot`, like `1.2.5.snapshot`.
116+
117+
- Update `DevelopmentSnapshots.asciidoc` version number.

src/_layouts/default.html

Lines changed: 22 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,30 @@
1616
<h1 class="project-name">{{ site.title | default: site.github.repository_name }}</h1>
1717
<h2 class="project-tagline">{{ site.description | default: site.github.project_tagline }}</h2>
1818
{% if site.show_downloads %}
19-
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.download_version }}/pasdoc-{{ site.pasdoc.download_version }}-win64.zip" class="btn">Windows (64-bit, x86_64)</a>
20-
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.download_version }}/pasdoc-{{ site.pasdoc.download_version }}-linux-x86_64.tar.gz" class="btn">Linux (64-bit, x86_64)</a>
21-
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.download_version }}/pasdoc-{{ site.pasdoc.download_version }}-linux-arm.tar.gz" class="btn">Raspberry Pi (Linux, 32-bit Arm)</a>
22-
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.download_version }}/pasdoc-{{ site.pasdoc.download_version }}-darwin-x86_64.zip" class="btn">macOS</a>
19+
<b>Stable version ({{ site.pasdoc.stable_download_version }}):</b>
20+
<br>
21+
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-win64.zip" class="btn">Windows (x86_64)</a>
22+
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-linux-x86_64.tar.gz" class="btn">Linux (x86_64)</a>
23+
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-linux-arm.tar.gz" class="btn">Linux (Arm, 32-bit) (Raspberry Pi)</a>
24+
<a href="https://github.com/pasdoc/pasdoc/releases/download/v{{ site.pasdoc.stable_download_version }}/pasdoc-{{ site.pasdoc.stable_download_version }}-darwin-x86_64.zip" class="btn">macOS (x86_64)</a>
25+
26+
<br>
27+
<br>
28+
29+
<b>Unstable version ({{ site.pasdoc.unstable_download_version }}, more features and platforms):</b>
30+
<br>
31+
<a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-win64.zip" class="btn">Windows (x86_64)</a>
32+
<a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-linux-x86_64.tar.gz" class="btn">Linux (x86_64)</a>
33+
<a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-linux-arm.tar.gz" class="btn">Linux (Arm, 32-bit) (Raspberry Pi)</a>
34+
<a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-linux-aarch64.tar.gz" class="btn">Linux (Aarch64, 64-bit) (Raspberry Pi, PineTab2)</a>
35+
<a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-darwin-x86_64.zip" class="btn">macOS (x86_64)</a>
36+
<a href="https://github.com/pasdoc/pasdoc/releases/download/snapshot/pasdoc-{{ site.pasdoc.unstable_download_version }}-darwin-x86_64.zip" class="btn">macOS (Aarch64)</a>
2337
{% endif %}
2438
{% if site.github.is_project_page %}
25-
<a href="{{ site.pasdoc.repository_url }}" class="btn">Source Code (GitHub)</a>
39+
<br>
40+
<br>
41+
42+
<a href="{{ site.pasdoc.repository_url }}" class="btn">Source code (build with FPC or Delphi)</a>
2643
{% endif %}
2744
</section>
2845
{% endif %}

0 commit comments

Comments
 (0)