From 71b6f340450f080147b3846d640afd5ce54b2f76 Mon Sep 17 00:00:00 2001
From: Sharlatan Hellseher <sharlatanus@gmail.com>
Date: Fri, 27 Mar 2026 14:19:40 +0000
Subject: [PATCH] gnu: Add godoc.

* gnu/packages/golang-apps.scm (godoc): New variable.

Fixes: guix/guix#7450
Change-Id: I0b05ed1badae12927c305506f1f3928e158193d0
---
 gnu/packages/golang-apps.scm | 44 ++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)

diff --git a/gnu/packages/golang-apps.scm b/gnu/packages/golang-apps.scm
index 669d250c8d..5b87686dd8 100644
--- a/gnu/packages/golang-apps.scm
+++ b/gnu/packages/golang-apps.scm
@@ -179,6 +179,50 @@ C++implementation.")
 definitions in Go programs.")
     (license license:bsd-3)))
 
+(define-public godoc
+  (package
+    (name "godoc")
+    (version "0.1.0-deprecated")
+    (source
+     (origin
+       (method git-fetch)
+       (uri (git-reference
+              (url "https://go.googlesource.com/tools")
+              (commit (go-version->git-ref version #:subdir "cmd/godoc"))))
+       (file-name (git-file-name name version))
+       (sha256
+        (base32 "0c1rxbj3v3m0fqb8q96xlbawxm9scyx6vvr8pddkiwp7zkx4ajym"))
+       (modules '((guix build utils)
+                  (ice-9 ftw)
+                  (srfi srfi-26)))
+       (snippet
+        #~(begin
+            (define (delete-all-but directory . preserve)
+              (with-directory-excursion directory
+                (let* ((pred (negate (cut member <>
+                                          (cons* "." ".." preserve))))
+                       (items (scandir "." pred)))
+                  (for-each (cut delete-file-recursively <>) items))))
+            (delete-all-but "cmd" "godoc")
+            (delete-all-but "." "cmd")))))
+    (build-system go-build-system)
+    (arguments
+     (list
+      #:install-source? #f
+      #:import-path "golang.org/x/tools/cmd/godoc"
+      #:unpack-path "golang.org/x/tools"))
+    (native-inputs
+     (list go-golang-org-x-tools
+           go-golang-org-x-tools-godoc))
+    (home-page "https://golang.org/x/tools")
+    (synopsis "Extracts and generates documentation for Go programs")
+    (description
+     "Godoc extracts and generates documentation for Go programs.  It looks at
+the packages it finds via @code{$GOROOT} and @code{$GOPATH} (if set).  This
+behavior can be altered by providing an alternative @code{$GOROOT} with the
+@code{-goroot} flag.")
+    (license license:bsd-3)))
+
 (define-public gomacro
   (package
     (name "gomacro")