Merge remote-tracking branch 'origin/master' into cast_array_syntax

.cirrus.yml

@@ -2,7 +2,7 @@ env:
   LANG: en_US.UTF-8
 
 freebsd_instance:
-  image_family: freebsd-13-0
+  image_family: freebsd-14-0
 
 ## Note: all tasks should end with _script: here, otherwise they will not be picked up!
 freebsd_task:

.gitattributes

@@ -1,7 +1,10 @@
-*.v linguist-language=V text=auto eol=lf
-*.vv linguist-language=V text=auto eol=lf
-*.vsh linguist-language=V text=auto eol=lf
-**/v.mod linguist-language=V text=auto eol=lf
-*.bat text=auto eol=crlf
- Dockerfile.* linguist-language=Dockerfile
-*.toml text eol=lf
+* text=auto eol=lf
+*.bat eol=crlf
+
+*.v linguist-language=V
+*.vv linguist-language=V
+*.vsh linguist-language=V
+v.mod linguist-language=V
+.vdocignore linguist-language=ignore
+
+Dockerfile.* linguist-language=Dockerfile

.github/.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}

.github/ISSUE_TEMPLATE/documentation.yml

@@ -1,7 +1,6 @@
 name: 📕 Documentation Issue
 description: Report an issue in the Reference documentation or Developer Guide
-title: (short issue description)
-labels: "Unit: Documentation"
+labels: ['Unit: Documentation']
 body:
   - type: textarea
     id: description

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: 'github-actions'
+    directory: '/'
+    schedule:
+      interval: 'daily'

.github/workflows/bootstrapping_ci.yml

@@ -0,0 +1,91 @@
+name: Bootstrapping CI
+
+on:
+  workflow_dispatch:
+  push:
+    paths-ignore:
+      - '**.yml'
+      - '**.md'
+      - '**.vv'
+      - '**.out'
+      - 'cmd/tools/**'
+      - '!cmd/tools/builders/**.v'
+      - '!cmd/tools/vup.v'
+      - '!**/bootstrapping_ci.yml'
+  pull_request:
+    paths-ignore:
+      - '**.yml'
+      - '**.md'
+      - '**.vv'
+      - '**.out'
+      - 'cmd/tools/**'
+      - '!cmd/tools/builders/**.v'
+      - '!cmd/tools/vup.v'
+      - '!**/bootstrapping_ci.yml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref == 'refs/heads/master' && github.sha || github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  bootstrap-v:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-14]
+      fail-fast: false
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    env:
+      VFLAGS: -no-parallel
+      B_LFLAGS: -lm -lpthread
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Build V
+        run: make -j4
+      - name: Test bootstrapping (v.c can be compiled and run with -os cross)
+        run: |
+          ls -la v vc/v.c
+          ./v -os cross -o vc/v.c cmd/v
+          cc -o v_from_vc vc/v.c $B_LFLAGS
+          ls -lart v_from_vc
+          ./v_from_vc version
+          ./v_from_vc run examples/hello_world.v
+          ./v_from_vc -o v_from_vc_produced_native_v cmd/v
+          ./v_from_vc_produced_native_v run examples/hello_world.v
+          ### the next make invocation will simulate building V from scratch
+          make local=1
+          ls -la v vc/v.c v_from_vc v_from_vc_produced_native_v
+          ./v_from_vc_produced_native_v -os cross -o vc/v.c cmd/v
+          ### do it a second time, just in case:
+          clang -o v_from_vc2 vc/v.c $B_LFLAGS
+          ls -lart v_from_vc2
+          ./v_from_vc2 version
+          ./v_from_vc2 run examples/hello_world.v
+          ./v_from_vc2 -o v_from_vc_produced_native_v2 cmd/v
+          ./v_from_vc_produced_native_v2 run examples/hello_world.v
+          make local=1
+          ls -la v vc/v.c
+          ls -la v_from_vc v_from_vc_produced_native_v
+          ls -la v_from_vc2 v_from_vc_produced_native_v2
+      - name: Ensure V master is available
+        if: github.ref_name != 'master'
+        run: git branch master remotes/origin/master
+      - name: Test `v up`
+        run: |
+          # Derive a commit sha from an older successful fast workflow on master that was able to build V.
+          # The workflow used below is `Path Testing CI` (18477644).
+          recent_good_commit=$(curl -L \
+            -H "Accept: application/vnd.github+json" \
+            -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
+            -H "X-GitHub-Api-Version: 2022-11-28" \
+            "https://api.github.com/repos/vlang/v/actions/workflows/18477644/runs?branch=master&status=success&event=push&per_page=5&page=2" \
+            | jq -r '.workflow_runs[4].head_sha')
+          echo "recent_good_commit=$recent_good_commit"
+          # Build oldv at recent_good_commit.
+          ./v run cmd/tools/oldv.v -v $recent_good_commit
+          cd ~/.cache/oldv/v_at_$recent_good_commit
+          # Test updating
+          ./v version && ./v -v up && ./v version
+          ./v -o v2 cmd/v && ./v2 -o v3 cmd/v