[MacPorts] #39051: The example portfile in the "doc" folder of base should pass lint

[MacPorts]

#39051: The example portfile in the "doc" folder of base should pass lint
--------------------------+--------------------------------
  Reporter:  egall@…      |      Owner:  macports-tickets@…
      Type:  defect       |     Status:  new
  Priority:  Normal       |  Milestone:
 Component:  base         |    Version:  2.1.3
Resolution:               |   Keywords:
      Port:  exampleport  |
--------------------------+--------------------------------

Comment (by larryv@…):

 Replying to [comment:8 egall@…]:
 > People who've downloaded the source tarball and don't want to open
 > a web browser just to view documentation? It's common practice to
 > include documentation in source tarballs; people expect docs to be in
 > source tarballs, or else they wouldn't keep including them in their
 > own source tarballs.

 There’s a difference between the documentation that is //installed// and
 the documentation that is //only in the tarball//. I maintain that
 removing whatever documentation is not installed (e.g., moving `INTERNALS`
 somewhere else in the repository and deleting `exampleport`) would result
 in negligible, if not zero, complaints.

 (Excluding documentation that’s actually relevant to the distributing the
 source, like `LICENSE` and `NEWS`.)

-- 
Ticket URL: <https://trac.macports.org/ticket/39051#comment:11>
MacPorts <http://www.macports.org/>
Ports system for OS X