Add section to documentation about updating package version

Document includes a description for pumping the release, but what
if there is a completely new upstream version?  This patch adds a
section that describes how to update the upstream url for a
package and update the package information accordingly.

Signed-off-by: Kevron Rees <kevron.m.rees@intel.com>

Makefile.common

@@ -28,16 +28,18 @@ __missingsources := $(filter-out $(wildcard ${__allsources}), ${__allsources})
 endif
 
 $(SPECFILE):
-	@echo Error: $(SPECFILE) is missing. Please run \`make autospec\` to try and auto
-	@echo Error: generate one for you.
-	@exit 1
+	@[[ -f "$@" ]] || (\
+	  echo Error: $@ is missing. Please run \`make autospec\` to try and auto;\
+	  echo Error: generate one for you.;\
+	  exit 1 )
 
 upstream:
-	@echo Error: The \"upstream\" file is missing. Try running \`make autospec\` to
-	@echo Error: auto generate one for you. If you are not using autospec to
-	@echo Error: generate a spec file, specify the proper "Source*" entries in the
-	@echo Error: spec header, and try running \`make generateupstream\`.
-	@exit 1
+	@[[ -f "$@" ]] || (\
+	  echo Error: The \"$@\" file is missing. Try running \`make autospec\` to;\
+	  echo Error: auto generate one for you. If you are not using autospec to;\
+	  echo Error: generate a spec file, specify the proper "Source*" entries in the;\
+	  echo Error: spec header, and try running \`make generateupstream\`.;\
+	  exit 1 )
 
 #help spdxcheck: Checks that the package license is a valid SPDX license,
 #help or that it is in the exceptions list.

Makefile.shared

@@ -158,7 +158,7 @@ require-pkg-repo-dir:
 link-new-rpms: require-pkg-repo-dir
 	mkdir -p ${PKG_REPO_DIR}/rpms
 	rm -f ${PKG_REPO_DIR}/rpms/*.rpm
-	find ${PKG_REPO_DIR}/results -name '*.rpm' -exec ln {} ${PKG_REPO_DIR}/rpms/ \;
+	find ${PKG_REPO_DIR}/results -maxdepth 1 -name '*.rpm' -exec ln {} ${PKG_REPO_DIR}/rpms/ \;
 	rm -f ${PKG_REPO_DIR}/rpms/*.src.rpm
 
 

README.md

@@ -102,6 +102,10 @@ $ echo missing-build-req >> buildreq_add
 $ make autospec
 ```
 
+Please see https://github.com/clearlinux/autospec#common-files for 
+documention on buildreq_add and the other files autospec uses during the
+build process.
+
 ### Bump the release number for a package
 
 If you simply need to increment a package's release number and rebuild the
@@ -112,6 +116,16 @@ $ make bump
 $ make build
 ```
 
+### Update the release version for a package
+
+If you have an update release version for a package, you can change the url
+for the new release in the package/example-pkg/Makefile.  After modifying the
+new url, run `make autospec` again to fetch the new package and rebuild.
+
+```
+$ make autospec
+```
+
 ## Other topics
 
 ### Customizing the mock config

packages

@@ -8,6 +8,7 @@ Flask
 FreeRDP
 GConf
 GitPython
+ImageMagick
 Jinja2
 Keras
 Keras_Applications
@@ -140,6 +141,8 @@ R-Rsolnp
 R-Rtsne
 R-Rvmmin
 R-SDMTools
+R-SGP
+R-SGPdata
 R-SQUAREM
 R-Sleuth2
 R-SnowballC
@@ -446,6 +449,7 @@ R-maxLik
 R-mclust
 R-mcmc
 R-mda
+R-measures
 R-memisc
 R-memoise
 R-mi
@@ -705,6 +709,7 @@ R-urltools
 R-uroot
 R-utf8
 R-uuid
+R-varImp
 R-vcd
 R-vcdExtra
 R-vcr
@@ -764,7 +769,9 @@ WireGuard
 XStatic
 XStatic-Angular
 XStatic-Angular-Bootstrap
+XStatic-Angular-FileUpload
 XStatic-Angular-Gettext
+XStatic-Angular-Schema-Form
 XStatic-Angular-lrdragndrop
 XStatic-Bootstrap-Datepicker
 XStatic-Bootstrap-SCSS
@@ -783,9 +790,11 @@ XStatic-bootswatch
 XStatic-jQuery
 XStatic-jquery-ui
 XStatic-mdi
+XStatic-objectpath
 XStatic-roboto-fontface
 XStatic-smart-table
 XStatic-term.js
+XStatic-tv4
 Z3
 abireport
 absl-py
@@ -863,6 +872,7 @@ baloo
 baloo-widgets
 bandit
 baobab
+barbican
 bash
 bash-completion
 bash.static
@@ -970,6 +980,7 @@ clr-avx-tools
 clr-boot-manager
 clr-debug-info
 clr-desktop-defaults
+clr-fwupd-hooks
 clr-hardware-files
 clr-init
 clr-man-pages
@@ -994,6 +1005,7 @@ cni
 cni-plugins
 cockpit
 cogl
+coinmp
 colcon-bash
 colcon-cmake
 colcon-common-extensions
@@ -1039,7 +1051,6 @@ compat-opencv-soname32
 compat-opencv-soname33
 compat-protobuf-soname14
 compat-protobuf-soname15
-compat-python36
 compat-readline
 component
 compute-image-packages
@@ -1076,6 +1087,7 @@ cups
 cups-filters
 cups-pk-helper
 curl
+cursive
 cve-check-tool
 cxxfilt
 cycler
@@ -1094,6 +1106,7 @@ debugedit
 decorator
 defusedxml
 dejagnu
+deprecation
 desktop-file-utils
 dfc
 dfu-util
@@ -1177,6 +1190,7 @@ fann
 farstream
 fasteners
 fcgi
+feh
 fftw
 file
 file-roller
@@ -1220,6 +1234,7 @@ futures
 futurist
 fwupd
 fwupdate
+gabbi
 garcon
 gast
 gawk
@@ -1249,6 +1264,7 @@ gftp
 ghostscript
 gimp
 git
+gitdb2
 gitolite
 gjs
 glance
@@ -1259,6 +1275,7 @@ glib
 glib-networking
 glibc
 glibmm
+glm
 glmark2
 global
 glog
@@ -1327,6 +1344,7 @@ gptfdisk
 gradle
 gradle-dep
 graphene
+graphite
 graphviz
 greenlet
 grep
@@ -1387,6 +1405,7 @@ hunspell
 hwloc
 hyperscan
 hyperstart
+hyphen
 hypothesis
 i2c-tools
 i3
@@ -1414,6 +1433,7 @@ intel-gpu-tools
 intel-hybrid-driver
 intltool
 invm-frameworks
+ioc-cbc-tools
 ioping
 iotop
 ipaddr
@@ -1432,6 +1452,8 @@ ipython
 ipython-sql
 ipython_genutils
 ipywidgets
+ironic
+ironic-lib
 irqbalance
 irrlicht
 irssi
@@ -1459,6 +1481,8 @@ json-c
 json-glib
 jsoncpp
 jsonpatch
+jsonpath-rw
+jsonpath-rw-ext
 jsonpointer
 jsonschema
 jupyter
@@ -1500,6 +1524,7 @@ kdnssd
 kdoctools
 keepassxc
 kemoticons
+kernel-config
 kernel-config-checker
 kernel-install
 kexec-tools
@@ -1559,6 +1584,7 @@ latencytop
 lazy-object-proxy
 lcms2
 lcov
+ldap3
 lensfun
 less
 leveldb
@@ -1619,6 +1645,7 @@ libdmx
 libdnf
 libdrm
 libepoxy
+liberasurecode
 libev
 libevdev
 libevent
@@ -1795,6 +1822,7 @@ metrics-discovery
 micro-config-drive
 micro-config-drive-aws
 micro-config-drive-oci
+microversion_parse
 mido
 minetest
 minetest_game
@@ -1810,6 +1838,7 @@ mock
 mod_wsgi
 moka-icon-theme
 mongodict
+mono
 monotonic
 more-itertools
 moreutils
@@ -1827,19 +1856,21 @@ mpfr
 mpg123
 mpi4py
 mpmath
-msgpack-python
+msgpack
 msmtp
 msr-tools
 mstflint
 mtdev
 multimon-ng
 multipath-tools
+munch
 murrine
 musl
 mutt
 mutter
 mypaint-brushes
 mypy
+mythes
 nagios-plugins
 nano
 nasm
@@ -1863,6 +1894,7 @@ network-manager-applet
 networkmanager-qt
 networkx
 neutron
+neutron-lib
 newt
 nfs-utils
 nftables
@@ -1877,6 +1909,7 @@ nose
 nose-cov
 nose-cover3
 nose-parameterized
+nosexcover
 nosync
 notebook
 notmuch
@@ -1932,11 +1965,16 @@ opusfile
 orc
 orca
 ordereddict
+os-api-ref
 os-autoinst
 os-brick
 os-client-config
+os-service-types
 os-testr
+os-traits
 os-win
+os-xenapi
+os_vif
 osc-lib
 osinfo-db-tools
 oslo.cache
@@ -1949,6 +1987,7 @@ oslo.log
 oslo.messaging
 oslo.middleware
 oslo.policy
+oslo.privsep
 oslo.reports
 oslo.rootwrap
 oslo.serialization
@@ -1961,6 +2000,8 @@ oslotest
 osprofiler
 ostree
 ovirt-guest-agent
+ovs
+ovsdbapp
 p11-kit
 p7zip
 packaging
@@ -1990,6 +2031,7 @@ pcre
 pcre2
 pecan
 pep8
+performance
 perftest
 perl
 perl-Acme-Damn
@@ -2162,6 +2204,7 @@ perl-File-FcntlLock
 perl-File-Find-Rule
 perl-File-Grep
 perl-File-HomeDir
+perl-File-KeePass
 perl-File-LibMagic
 perl-File-Listing
 perl-File-MMagic
@@ -2441,8 +2484,10 @@ perl-System-Command
 perl-TAP-Harness-Archive
 perl-Taint-Util
 perl-Term-ProgressBar
+perl-Term-ReadLine-Gnu
 perl-Term-ReadPassword
 perl-Term-Shell
+perl-Term-ShellUI
 perl-Term-Size-Perl
 perl-Term-Table
 perl-Term-UI
@@ -2620,6 +2665,7 @@ pwgen
 py
 pyOpenSSL
 pyScss
+pyaes
 pyaml
 pyasn1
 pyasn1-modules
@@ -2634,6 +2680,7 @@ pydocstyle
 pydot
 pydot_ng
 pydotplus
+pyeclib
 pyemd
 pyflakes
 pygobject
@@ -2645,10 +2692,14 @@ pymongo
 pynacl
 pypandoc
 pyparsing
+pyperclip
+pypowervm
 pyquery
 pyrfc3339
+pyroute2
 pyrsistent
 pysaml2
+pysendfile
 pyserial
 pysnmp
 pytest
@@ -2686,6 +2737,7 @@ python-multilib
 python-neutronclient
 python-novaclient
 python-openstackclient
+python-perf
 python-pkgconfig
 python-pocketlint
 python-polib
@@ -2749,12 +2801,15 @@ quagga
 quilt
 rabbitmq-c
 ragel
+raptor2
+rasqal
 rcssmin
 rdma-core
 re2c
 readline
 redis
 redis-native
+redland
 redsocks
 reno
 repoze.lru
@@ -2786,6 +2841,7 @@ runc
 rust-std32
 rustc
 rxvt-unicode
+ryu
 s2tc
 s3transfer
 sahara
@@ -2804,6 +2860,7 @@ scipy
 scons
 screen
 scripttest
+scrypt
 sddm
 seaborn
 seahorse
@@ -2834,12 +2891,14 @@ slang
 smart_open
 smartcols
 smartmontools
+smmap2
 snappy
 snowballstemmer
 socat
 sof-crosstool-ng
 solid
 sonnet
+sortedcontainers
 sos
 soundmodem
 source-code-pro
@@ -2865,12 +2924,15 @@ squashfs-tools
 sshfs
 stack
 startup-notification
+statsd
 statsmodels
+stestr
 stevedore
 stow
 strace
 stress-ng
 subunit
+subunit2sql
 subversion
 sudo
 suds-jurko
@@ -2930,6 +2992,7 @@ tiff
 tig
 tigervnc
 time
+tinyrpc
 tinyxml2
 tiptop
 tk
@@ -2960,6 +3023,7 @@ unicodecsv
 unifdef
 unison
 unittest2
+unixODBC
 unzip
 upower
 uritemplate
@@ -2998,6 +3062,7 @@ warlock
 wayland
 wayland-protocols
 wcwidth
+weakrefmethod
 webcolors
 webencodings
 webkitgtk
@@ -3015,6 +3080,8 @@ woff2
 wol
 wpa_supplicant
 wrapt
+wsgi_intercept
+wsgiref
 x11perf
 x11vnc
 xapian-core