From c1e6ffbeb9ad41440de4a3a2cbbaf6f5dd7165c7 Mon Sep 17 00:00:00 2001
From: Finn Roberts <robe2037@umn.edu>
Date: Fri, 1 Sep 2023 16:27:40 -0400
Subject: [PATCH] Increment version number to 0.6.3

---
 DESCRIPTION |  2 +-
 NEWS.md     | 27 ++++++++++++++++++++++++++-
 2 files changed, 27 insertions(+), 2 deletions(-)

diff --git a/DESCRIPTION b/DESCRIPTION
index c49edb07..4c0901f3 100644
--- a/DESCRIPTION
+++ b/DESCRIPTION
@@ -1,6 +1,6 @@
 Package: ipumsr
 Title: An R Interface for Downloading, Reading, and Handling IPUMS Data
-Version: 0.6.2.9000
+Version: 0.6.3
 Authors@R: c(
     person("Greg Freedman Ellis", role = "aut"),
     person("Derek Burk", , , "ipums+cran@umn.edu", role = c("aut", "cre")),
diff --git a/NEWS.md b/NEWS.md
index c4950359..fbeba578 100644
--- a/NEWS.md
+++ b/NEWS.md
@@ -1,4 +1,29 @@
-# ipumsr (development version)
+# ipumsr 0.6.3
+
+* The ability to read an IPUMS DDI file contained within a zip archive using
+`read_ipums_ddi()` has been deprecated. Users must now load DDI files by 
+providing the direct path to the uncompressed .xml file.
+
+  This resolves an inconsistency between the behavior
+  of `read_ipums_micro_*()` functions when provided a DDI file path as compared to
+  an `ipums_ddi` object created with `read_ipums_ddi()`.
+
+* The ability to read IPUMS files by providing the path to their containing 
+directory has been deprecated. This affects:
+
+  - `read_nhgis()`
+  - `read_ipums_sf()`
+  - `read_nhgis_codebook()`
+  - `read_ipums_ddi()`
+  - `ipums_list_files()`
+  
+  These functions now require either a zip archive (with the exception of 
+  `read_ipums_ddi()`—see above) or a direct file path as input.
+  
+  This has the consequence that `read_ipums_sf()` with `bind_multiple = TRUE`
+  requires a zip archive as input if multiple files are to be read and combined.
+  
+* Documentation updates for clarity
 
 # ipumsr 0.6.2