diff --git a/devel/shfmt/Makefile b/devel/shfmt/Makefile
index adfb5ae12096..823461e2cc75 100644
--- a/devel/shfmt/Makefile
+++ b/devel/shfmt/Makefile
@@ -1,30 +1,32 @@
 # $FreeBSD$
 
 PORTNAME=	shfmt
 DISTVERSIONPREFIX=	v
 DISTVERSION=	3.1.2
 CATEGORIES=	devel
 
 MAINTAINER=	adamw@FreeBSD.org
-COMMENT=	Format shell scripts
+COMMENT=	Shell script formatter
 
 LICENSE=	BSD3CLAUSE
 LICENSE_FILE=	${WRKSRC}/LICENSE
 
 USES=		go:modules
 USE_GITHUB=	yes
 GH_ACCOUNT=	mvdan
 GH_PROJECT=	sh
 GH_TUPLE=	go-errgo:errgo:v2.1.0:go_errgo_errgo/vendor/gopkg.in/errgo.v2 \
 		golang:sys:9197077df867:golang_sys/vendor/golang.org/x/sys \
 		golang:term:ad39bd3f0407:golang_term/vendor/golang.org/x/term \
 		google:renameio:v0.1.0:google_renameio/vendor/github.com/google/renameio \
 		mvdan:editorconfig:e40951bde157:mvdan_editorconfig/vendor/mvdan.cc/editorconfig \
 		pkg:diff:531926345625:pkg_diff/vendor/github.com/pkg/diff \
 		rogpeppe:go-internal:v1.5.2:rogpeppe_go_internal/vendor/github.com/rogpeppe/go-internal
+
 GO_TARGET=	./cmd/shfmt
 GO_BUILDFLAGS=	-ldflags="-s -w -X main.version=${DISTVERSIONFULL}"
 GO_TESTTARGET=	./cmd/shfmt
+
 PLIST_FILES=	bin/shfmt
 
 .include <bsd.port.mk>
diff --git a/devel/shfmt/pkg-descr b/devel/shfmt/pkg-descr
index ace5bfb52ca1..0a0ecb3a0d12 100644
--- a/devel/shfmt/pkg-descr
+++ b/devel/shfmt/pkg-descr
@@ -1,4 +1,12 @@
-Shfmt is a shell script formatter.  It supports POSIX Shell, Bash,
-and mksh.
+shfmt formats shell programs. It can use tabs or any number of spaces to
+indent.
+
+You can feed it standard input, any number of files or any number of
+directories to recurse into. When recursing, it will operate on .sh and .bash
+files and ignore files starting with a period. It will also operate on files
+with no extension and a shell shebang.
+
+If any EditorConfig files are found, they will be used to apply formatting
+options.
 
 WWW: https://github.com/mvdan/sh