Skip to content

Instantly share code, notes, and snippets.

@grahamperrin
Created December 31, 2021 10:27
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save grahamperrin/345d49b94aab7d90239c6ea76995ef28 to your computer and use it in GitHub Desktop.
Save grahamperrin/345d49b94aab7d90239c6ea76995ef28 to your computer and use it in GitHub Desktop.
Working with a local copy of my fork of the FreeBSD documentation repository

Working with a local copy of my fork of the FreeBSD documentation repository

Rough notes to self.

cd /usr/doc && rm -r *

– then remove hidden files.

git -C /usr clone -o grahamperrin -b patch-1 https://github.com/grahamperrin/freebsd-doc.git doc

  • nonorthodox, but it suits me for now.

https://github.com/grahamperrin/freebsd-doc/tree/patch-1

fetch upstream

git -C /usr/doc pull --ff-only && git -C /usr/ports pull --ff-only && git -C /usr/src pull --ff-only

  • repeat until no upate is found.

cd /usr/doc/documentation && make run


Partial transcripts:

root@mowa219-gjp4-8570p-freebsd:/usr/doc/documentation/content/en/articles/problem-reports # make run
make: don't know how to make run. Stop

make: stopped in /usr/doc/documentation/content/en/articles/problem-reports
root@mowa219-gjp4-8570p-freebsd:/usr/doc/documentation/content/en/articles/problem-reports # cd ../../../../
root@mowa219-gjp4-8570p-freebsd:/usr/doc/documentation # make run
…
  • insane then sane paths for make run.
root@mowa219-gjp4-8570p-freebsd:/usr/doc/documentation # git -C /usr/doc pull --ff-only && git -C /usr/ports pull --ff-only && git -C /usr/src pull --ff-only
remote: Enumerating objects: 8, done.
remote: Counting objects: 100% (8/8), done.
remote: Compressing objects: 100% (7/7), done.
remote: Total 8 (delta 0), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (8/8), 13.61 KiB | 79.00 KiB/s, done.
From https://github.com/grahamperrin/freebsd-doc
   8fd808ad18..7491a86b7b  patch-1    -> grahamperrin/patch-1
Updating 8fd808ad18..7491a86b7b
Fast-forward
 documentation/content/en/articles/problem-reports/_index.adoc | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
remote: Enumerating objects: 19, done.
remote: Counting objects: 100% (19/19), done.
remote: Compressing objects: 100% (11/11), done.
remote: Total 11 (delta 7), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (11/11), 1.28 KiB | 7.00 KiB/s, done.
From https://git.freebsd.org/ports
   4807e7f988d5..b71e61991b19  main       -> freebsd/main
Updating 4807e7f988d5..b71e61991b19
Fast-forward
 security/vuxml/vuln-2021.xml        | 26 ++++++++++++++++++++++++++
 www/nextcloud-appointments/Makefile |  2 +-
 www/nextcloud-appointments/distinfo |  6 +++---
 3 files changed, 30 insertions(+), 4 deletions(-)
Already up to date.
root@mowa219-gjp4-8570p-freebsd:/usr/doc/documentation # make run
…
Built in 612988 ms
Watching for changes in /usr/doc/documentation/{archetypes,content,static,themes}
Watching for config changes in /usr/doc/documentation/config/_default
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop
^C
root@mowa219-gjp4-8570p-freebsd:/usr/doc/documentation # history -S
root@mowa219-gjp4-8570p-freebsd:/usr/doc/documentation # 
  • note the watching.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment