diff --git a/doc/manpages/account-server.conf.5 b/doc/manpages/account-server.conf.5 index acc1742b..80677e0c 100644 --- a/doc/manpages/account-server.conf.5 +++ b/doc/manpages/account-server.conf.5 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/container-server.conf.5 b/doc/manpages/container-server.conf.5 index 406545b1..08575869 100644 --- a/doc/manpages/container-server.conf.5 +++ b/doc/manpages/container-server.conf.5 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/dispersion.conf.5 b/doc/manpages/dispersion.conf.5 index 83553044..dd2f44c2 100644 --- a/doc/manpages/dispersion.conf.5 +++ b/doc/manpages/dispersion.conf.5 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/object-expirer.conf.5 b/doc/manpages/object-expirer.conf.5 index 8de307ee..e604e42d 100644 --- a/doc/manpages/object-expirer.conf.5 +++ b/doc/manpages/object-expirer.conf.5 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2012 OpenStack, LLC. +.\" Copyright (c) 2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/object-server.conf.5 b/doc/manpages/object-server.conf.5 index 4087cde1..e43cc391 100644 --- a/doc/manpages/object-server.conf.5 +++ b/doc/manpages/object-server.conf.5 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/proxy-server.conf.5 b/doc/manpages/proxy-server.conf.5 index 47638ff1..d83ca8e6 100644 --- a/doc/manpages/proxy-server.conf.5 +++ b/doc/manpages/proxy-server.conf.5 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-account-auditor.1 b/doc/manpages/swift-account-auditor.1 index 86e60fbb..14c8e137 100644 --- a/doc/manpages/swift-account-auditor.1 +++ b/doc/manpages/swift-account-auditor.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-account-reaper.1 b/doc/manpages/swift-account-reaper.1 index 4dc1f729..66003a6c 100644 --- a/doc/manpages/swift-account-reaper.1 +++ b/doc/manpages/swift-account-reaper.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-account-replicator.1 b/doc/manpages/swift-account-replicator.1 index 7df81ed8..f0b9bbbd 100644 --- a/doc/manpages/swift-account-replicator.1 +++ b/doc/manpages/swift-account-replicator.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-account-server.1 b/doc/manpages/swift-account-server.1 index 21ba86f7..a59ec25e 100644 --- a/doc/manpages/swift-account-server.1 +++ b/doc/manpages/swift-account-server.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-container-auditor.1 b/doc/manpages/swift-container-auditor.1 index 2718f043..462870d1 100644 --- a/doc/manpages/swift-container-auditor.1 +++ b/doc/manpages/swift-container-auditor.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-container-replicator.1 b/doc/manpages/swift-container-replicator.1 index 0469c78f..96fb8fbd 100644 --- a/doc/manpages/swift-container-replicator.1 +++ b/doc/manpages/swift-container-replicator.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-container-server.1 b/doc/manpages/swift-container-server.1 index 20cc5aeb..9a478968 100644 --- a/doc/manpages/swift-container-server.1 +++ b/doc/manpages/swift-container-server.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-container-sync.1 b/doc/manpages/swift-container-sync.1 index 11669ec1..e35e559a 100644 --- a/doc/manpages/swift-container-sync.1 +++ b/doc/manpages/swift-container-sync.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-container-updater.1 b/doc/manpages/swift-container-updater.1 index 9ec709ce..a90802d9 100644 --- a/doc/manpages/swift-container-updater.1 +++ b/doc/manpages/swift-container-updater.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-dispersion-populate.1 b/doc/manpages/swift-dispersion-populate.1 index 27188cef..824a94ad 100644 --- a/doc/manpages/swift-dispersion-populate.1 +++ b/doc/manpages/swift-dispersion-populate.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. @@ -71,16 +71,19 @@ Example \fI/etc/swift/dispersion.conf\fR: .IP "# concurrency = 25" .RE .PD - .SH EXAMPLE + +.SH EXAMPLE .PP .PD 0 $ swift-dispersion-populate .RS 1 .IP "Created 2621 containers for dispersion reporting, 38s, 0 retries" .IP "Created 2621 objects for dispersion reporting, 27s, 0 retries" -.RE +.RE + .PD - + + .SH DOCUMENTATION .LP More in depth documentation about the swift-dispersion utilities and diff --git a/doc/manpages/swift-dispersion-report.1 b/doc/manpages/swift-dispersion-report.1 index 2b0ffcd7..cadfb02e 100644 --- a/doc/manpages/swift-dispersion-report.1 +++ b/doc/manpages/swift-dispersion-report.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. @@ -100,11 +100,13 @@ Example \fI/etc/swift/dispersion.conf\fR: .IP "# dump_json = no" .RE .PD - .SH EXAMPLE + +.SH EXAMPLE .PP .PD 0 $ swift-dispersion-report - + + .RS 1 .IP "Queried 2622 containers for dispersion reporting, 31s, 0 retries" .IP "100.00% of container copies found (7866 of 7866)" @@ -113,9 +115,11 @@ $ swift-dispersion-report .IP "Queried 2621 objects for dispersion reporting, 22s, 0 retries" .IP "100.00% of object copies found (7863 of 7863)" .IP "Sample represents 1.00% of the object partition space" -.RE +.RE + .PD - + + .SH DOCUMENTATION .LP More in depth documentation about the swift-dispersion utilities and diff --git a/doc/manpages/swift-get-nodes.1 b/doc/manpages/swift-get-nodes.1 index d9409c58..cf1f3c2f 100644 --- a/doc/manpages/swift-get-nodes.1 +++ b/doc/manpages/swift-get-nodes.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. @@ -55,14 +55,18 @@ where the container resides by using the container ring. .IP "Server:Port Device 172.24.24.27:6002 sdr" .IP "Server:Port Device 172.24.24.32:6002 sde" .IP "Server:Port Device 172.24.24.26:6002 sdv [Handoff]" - + + .IP "curl -I -XHEAD http://172.24.24.29:6002/sdd/221082/MyAccount-12ac01446be2" .IP "curl -I -XHEAD http://172.24.24.27:6002/sdr/221082/MyAccount-12ac01446be2" .IP "curl -I -XHEAD http://172.24.24.32:6002/sde/221082/MyAccount-12ac01446be2" .IP "curl -I -XHEAD http://172.24.24.26:6002/sdv/221082/MyAccount-12ac01446be2 # [Handoff]" .IP "ssh 172.24.24.29 ls -lah /srv/node/sdd/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/ " -.IP "ssh 172.24.24.27 ls -lah /srv/node/sdr/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/" .IP "ssh 172.24.24.32 ls -lah /srv/node/sde/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/" .IP "ssh 172.24.24.26 ls -lah /srv/node/sdv/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/ # [Handoff] " +.IP "ssh 172.24.24.27 ls -lah /srv/node/sdr/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/" +.IP "ssh 172.24.24.32 ls -lah /srv/node/sde/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/" +.IP "ssh 172.24.24.26 ls -lah /srv/node/sdv/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/ # [Handoff] " + .PD .RE diff --git a/doc/manpages/swift-init.1 b/doc/manpages/swift-init.1 index d1de6609..5a24787b 100644 --- a/doc/manpages/swift-init.1 +++ b/doc/manpages/swift-init.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. @@ -111,7 +111,8 @@ allows one to use the keywords such as "all", "main" and "rest" for the .IP "-r RUN_DIR, --run-dir=RUN_DIR directory where the pids will be stored (default /var/run/swift) .PD .RE - + + .SH DOCUMENTATION .LP diff --git a/doc/manpages/swift-object-auditor.1 b/doc/manpages/swift-object-auditor.1 index 5be92267..34d12a44 100644 --- a/doc/manpages/swift-object-auditor.1 +++ b/doc/manpages/swift-object-auditor.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-object-expirer.1 b/doc/manpages/swift-object-expirer.1 index 24e1cbb0..869b2ac2 100644 --- a/doc/manpages/swift-object-expirer.1 +++ b/doc/manpages/swift-object-expirer.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2012 OpenStack, LLC. +.\" Copyright (c) 2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-object-info.1 b/doc/manpages/swift-object-info.1 index fe38638b..c89ec7cb 100644 --- a/doc/manpages/swift-object-info.1 +++ b/doc/manpages/swift-object-info.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-object-replicator.1 b/doc/manpages/swift-object-replicator.1 index 71c0383a..bbc33fee 100644 --- a/doc/manpages/swift-object-replicator.1 +++ b/doc/manpages/swift-object-replicator.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-object-server.1 b/doc/manpages/swift-object-server.1 index e3d0d346..d4ae197a 100644 --- a/doc/manpages/swift-object-server.1 +++ b/doc/manpages/swift-object-server.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-object-updater.1 b/doc/manpages/swift-object-updater.1 index 254b3499..63bc173c 100644 --- a/doc/manpages/swift-object-updater.1 +++ b/doc/manpages/swift-object-updater.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2012 OpenStack, LLC. +.\" Copyright (c) 2010-2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-orphans.1 b/doc/manpages/swift-orphans.1 index d274753d..3a6611e9 100644 --- a/doc/manpages/swift-orphans.1 +++ b/doc/manpages/swift-orphans.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2012 OpenStack, LLC. +.\" Copyright (c) 2012 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-proxy-server.1 b/doc/manpages/swift-proxy-server.1 index 2a4b6c36..73528379 100644 --- a/doc/manpages/swift-proxy-server.1 +++ b/doc/manpages/swift-proxy-server.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-recon.1 b/doc/manpages/swift-recon.1 index a9745c28..5bfa6619 100644 --- a/doc/manpages/swift-recon.1 +++ b/doc/manpages/swift-recon.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. diff --git a/doc/manpages/swift-ring-builder.1 b/doc/manpages/swift-ring-builder.1 index 59f7736e..c21c9e7d 100644 --- a/doc/manpages/swift-ring-builder.1 +++ b/doc/manpages/swift-ring-builder.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. @@ -204,7 +204,8 @@ calls when no rebalance is needed but you want to send out the new device inform .PD - + + .SH DOCUMENTATION .LP More in depth documentation about the swift ring and also Openstack-Swift as a diff --git a/doc/manpages/swift.1 b/doc/manpages/swift.1 index 9e86dd16..42291fa4 100644 --- a/doc/manpages/swift.1 +++ b/doc/manpages/swift.1 @@ -1,6 +1,6 @@ .\" .\" Author: Joao Marcelo Martins or -.\" Copyright (c) 2010-2011 OpenStack, LLC. +.\" Copyright (c) 2010-2011 OpenStack Foundation. .\" .\" Licensed under the Apache License, Version 2.0 (the "License"); .\" you may not use this file except in compliance with the License. @@ -68,7 +68,8 @@ items to set in the form Name:Value. This option can be repeated. \fBExample\fR: post -m Color:Blue -m Size:Large .RE - \fBdownload\fR [\fIcommand-options\fR] [\fIcontainer\fR] [\fIobject\fR] [\fIobject\fR] [...] + +\fBdownload\fR [\fIcommand-options\fR] [\fIcontainer\fR] [\fIobject\fR] [\fIobject\fR] [...] .RS 4 Downloads everything in the account (with --all), or everything in a container, or a list of objects depending on the args given. For a single @@ -76,14 +77,17 @@ object download, you may use the -o [--output] option to redirect the output to a specific file or if "-" then just redirect to stdout. .RE -\fBdelete\fR [\fIcommand-options\fR] [\fIcontainer\fR] [\fIobject\fR] [\fIobject\fR] [...] +\fBdelete\fR [\fIcommand-options\fR] [\fIcontainer\fR] [\fIobject\fR] [\fIobject\fR] [...] + .RS 4 Deletes everything in the account (with --all), or everything in a container, or a list of objects depending on the args given. Segments of manifest objects -will be deleted as well, unless you specify the --leave-segments option. +will be deleted as well, unless you specify the --leave-segments option. + .RE - .SH OPTIONS + +.SH OPTIONS .PD 0 .IP "--version Show program's version number and exit" .IP "-h, --help Show this help message and exit" @@ -92,10 +96,12 @@ will be deleted as well, unless you specify the --leave-segments option. .IP "-q, --quiet Suppress status output" .IP "-A AUTH, --auth=AUTH URL for obtaining an auth token " .IP "-U USER, --user=USER User name for obtaining an auth token" -.IP "-K KEY, --key=KEY Key for obtaining an auth token" +.IP "-K KEY, --key=KEY Key for obtaining an auth token" + .PD - .SH EXAMPLE + +.SH EXAMPLE .PP swift -A https://127.0.0.1:443/auth/v1.0 -U swiftops:swiftops -K swiftops stat @@ -110,7 +116,8 @@ swift -A https://127.0.0.1:443/auth/v1.0 -U swiftops:swiftops -K swiftops stat .PD .RE - + + .SH DOCUMENTATION .LP More in depth documentation about Openstack-Swift as a whole can be found at diff --git a/doc/source/_ga/layout.html b/doc/source/_ga/layout.html index 876fe009..3d0ab0e8 100644 --- a/doc/source/_ga/layout.html +++ b/doc/source/_ga/layout.html @@ -8,9 +8,8 @@ {% endblock %} diff --git a/doc/source/conf.py b/doc/source/conf.py index c1cb24dd..9b1b86ce 100644 --- a/doc/source/conf.py +++ b/doc/source/conf.py @@ -1,5 +1,5 @@ # -*- coding: utf-8 -*- -# Copyright (c) 2010-2012 OpenStack, LLC. +# Copyright (c) 2010-2012 OpenStack Foundation. # # Swift documentation build configuration file, created by # sphinx-quickstart on Tue May 18 13:50:15 2010. @@ -15,6 +15,7 @@ import sys import os +import datetime # If extensions (or modules to document with autodoc) are in another directory, # add these directories to sys.path here. If the directory is relative to the @@ -52,7 +53,7 @@ # General information about the project. project = u'Swift' -copyright = u'2011-present, OpenStack, LLC' +copyright = u'%d, OpenStack Foundation' % datetime.datetime.now().year # The version info for the project you're documenting, acts as replacement for # |version| and |release|, also used in various other places throughout the diff --git a/doc/source/development_guidelines.rst b/doc/source/development_guidelines.rst index 5682233b..797ffbdb 100644 --- a/doc/source/development_guidelines.rst +++ b/doc/source/development_guidelines.rst @@ -61,10 +61,13 @@ More specifically: License and Copyright --------------------- -Every source file should have the following copyright and license statement at -the top:: +You can have the following copyright and license statement at +the top of each source file. Copyright assignment is optional. - # Copyright (c) 2010-2012 OpenStack, LLC. +New files should contain the current year. Substantial updates can have +another year added, and date ranges are not needed.:: + + # Copyright (c) 2013 OpenStack Foundation. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License.