[Pkg-zsh-devel] .orig tarball name

[Daniel Shahaf]

Axel Beckert wrote on Fri, 14 Feb 2020 21:25 +0100:
> Hi,
> 
> Daniel Shahaf wrote:
> > The package's upstream tarball, zsh_5.7.1.orig.tar.xz, is different to
> > upstream's release tarball, zsh-5.7.1.tar.xz:  
> 
> Yes, IIRC because the upstream tarball contains prebuilt man pages
> with IIRC "wrong" paths for Debian.
> 

*nod*

> > Could the .orig tarball be named with a +dfsg suffix, as per [1], in order
> > to self-document that it's different from upstream's artifact?  
> 
> This documentation is admittedly incomplete, because it silently
> assumes that the only reason for repackaging are license issues of
> single files, not purely technical issues.
> 
> So if we introduce that type of renaming, wie should use "+ds" for
> "debian source".
> 

I did wonder about +ds; I don't recall seeing it documented.

> I'd still prefer if we would move to the original upstream tar ball.
> 

I guess this would require a Makefile target to clean all those
generated files?

> Frank: Do you remember the exact reasoning?

I'm guessing, but perhaps the idea was to ensure that all the generated
files below can in fact be rebuilt from source?  Are there any clues in
comments in the code that generates the repacked tarball?

Cheers,

Daniel

The list of files that are present in only one of the two tarballs is:

--- upstream
+++ debian orig
@@ .. @@
-zsh-5.7.1/Doc/Zsh/manmodmenu.yo
-zsh-5.7.1/Doc/Zsh/modlist.yo
-zsh-5.7.1/Doc/Zsh/modmenu.yo
-zsh-5.7.1/Doc/help.txt
-zsh-5.7.1/Doc/help/alias
-zsh-5.7.1/Doc/help/autoload
-zsh-5.7.1/Doc/help/bg
-zsh-5.7.1/Doc/help/bindkey
-zsh-5.7.1/Doc/help/break
-zsh-5.7.1/Doc/help/builtin
-zsh-5.7.1/Doc/help/cap
-zsh-5.7.1/Doc/help/cd
-zsh-5.7.1/Doc/help/clone
-zsh-5.7.1/Doc/help/colon
-zsh-5.7.1/Doc/help/command
-zsh-5.7.1/Doc/help/comparguments
-zsh-5.7.1/Doc/help/compcall
-zsh-5.7.1/Doc/help/compctl
-zsh-5.7.1/Doc/help/compdescribe
-zsh-5.7.1/Doc/help/compfiles
-zsh-5.7.1/Doc/help/compgroups
-zsh-5.7.1/Doc/help/compquote
-zsh-5.7.1/Doc/help/comptags
-zsh-5.7.1/Doc/help/comptry
-zsh-5.7.1/Doc/help/compvalues
-zsh-5.7.1/Doc/help/continue
-zsh-5.7.1/Doc/help/dirs
-zsh-5.7.1/Doc/help/disable
-zsh-5.7.1/Doc/help/disown
-zsh-5.7.1/Doc/help/dot
-zsh-5.7.1/Doc/help/echo
-zsh-5.7.1/Doc/help/echotc
-zsh-5.7.1/Doc/help/echoti
-zsh-5.7.1/Doc/help/emulate
-zsh-5.7.1/Doc/help/enable
-zsh-5.7.1/Doc/help/eval
-zsh-5.7.1/Doc/help/exec
-zsh-5.7.1/Doc/help/exit
-zsh-5.7.1/Doc/help/export
-zsh-5.7.1/Doc/help/false
-zsh-5.7.1/Doc/help/fc
-zsh-5.7.1/Doc/help/fg
-zsh-5.7.1/Doc/help/functions
-zsh-5.7.1/Doc/help/getcap
-zsh-5.7.1/Doc/help/getln
-zsh-5.7.1/Doc/help/getopts
-zsh-5.7.1/Doc/help/hash
-zsh-5.7.1/Doc/help/jobs
-zsh-5.7.1/Doc/help/kill
-zsh-5.7.1/Doc/help/let
-zsh-5.7.1/Doc/help/limit
-zsh-5.7.1/Doc/help/log
-zsh-5.7.1/Doc/help/noglob
-zsh-5.7.1/Doc/help/popd
-zsh-5.7.1/Doc/help/print
-zsh-5.7.1/Doc/help/printf
-zsh-5.7.1/Doc/help/pushd
-zsh-5.7.1/Doc/help/pwd
-zsh-5.7.1/Doc/help/read
-zsh-5.7.1/Doc/help/return
-zsh-5.7.1/Doc/help/sched
-zsh-5.7.1/Doc/help/set
-zsh-5.7.1/Doc/help/setcap
-zsh-5.7.1/Doc/help/setopt
-zsh-5.7.1/Doc/help/shift
-zsh-5.7.1/Doc/help/source
-zsh-5.7.1/Doc/help/stat
-zsh-5.7.1/Doc/help/suspend
-zsh-5.7.1/Doc/help/test
-zsh-5.7.1/Doc/help/times
-zsh-5.7.1/Doc/help/trap
-zsh-5.7.1/Doc/help/true
-zsh-5.7.1/Doc/help/ttyctl
-zsh-5.7.1/Doc/help/typeset
-zsh-5.7.1/Doc/help/ulimit
-zsh-5.7.1/Doc/help/umask
-zsh-5.7.1/Doc/help/unhash
-zsh-5.7.1/Doc/help/unlimit
-zsh-5.7.1/Doc/help/unset
-zsh-5.7.1/Doc/help/unsetopt
-zsh-5.7.1/Doc/help/vared
-zsh-5.7.1/Doc/help/wait
-zsh-5.7.1/Doc/help/whence
-zsh-5.7.1/Doc/help/zcompile
-zsh-5.7.1/Doc/help/zformat
-zsh-5.7.1/Doc/help/zftp
-zsh-5.7.1/Doc/help/zle
-zsh-5.7.1/Doc/help/zmodload
-zsh-5.7.1/Doc/help/zparseopts
-zsh-5.7.1/Doc/help/zprof
-zsh-5.7.1/Doc/help/zpty
-zsh-5.7.1/Doc/help/zregexparse
-zsh-5.7.1/Doc/help/zsocket
-zsh-5.7.1/Doc/help/zstyle
-zsh-5.7.1/Doc/help/ztcp
-zsh-5.7.1/Doc/version.yo
-zsh-5.7.1/Doc/zsh.1
-zsh-5.7.1/Doc/zsh.texi
-zsh-5.7.1/Doc/zshall.1
-zsh-5.7.1/Doc/zshbuiltins.1
-zsh-5.7.1/Doc/zshcalsys.1
-zsh-5.7.1/Doc/zshcompctl.1
-zsh-5.7.1/Doc/zshcompsys.1
-zsh-5.7.1/Doc/zshcompwid.1
-zsh-5.7.1/Doc/zshcontrib.1
-zsh-5.7.1/Doc/zshexpn.1
-zsh-5.7.1/Doc/zshmisc.1
-zsh-5.7.1/Doc/zshmodules.1
-zsh-5.7.1/Doc/zshoptions.1
-zsh-5.7.1/Doc/zshparam.1
-zsh-5.7.1/Doc/zshroadmap.1
-zsh-5.7.1/Doc/zshtcpsys.1
-zsh-5.7.1/Doc/zshzftpsys.1
-zsh-5.7.1/Doc/zshzle.1
-zsh-5.7.1/Etc/FAQ
-zsh-5.7.1/META-FAQ
-zsh-5.7.1/Src/patchlevel.h.release
-zsh-5.7.1/config.h.in
-zsh-5.7.1/configure
-zsh-5.7.1/stamp-h.in
+zsh-5.7.1/Util/difflog.pl

So the orig tarball removes some generated files and adds
Util/difflog.pl, which has no license header and in any case
doesn't need to be distributed, according to
http://www.zsh.org/mla/workers/2007/msg01065.html (h/t dana).