This issue tracks deprecations that could be advanced in a future readr release.

Is it time to soft deprecate the first edition? In readr 2.0.0, we said:

We will continue to support the first edition for a number of releases, but eventually this support will be first deprecated and then removed.

Deprecated in readr 2.0.0 (2021-07-20)

✅ Melt functions

• Removed inRemove all the melt functions #1598
• Functions affected:
  • melt_csv(),melt_csv2(),melt_delim(),melt_tsv() (were inR/melt_delim.R)
  • melt_fwf() (was inR/melt_fwf.R)
  • melt_table(),melt_table2() (were inR/melt_table.R)
  • melt_csv_chunked(),melt_csv2_chunked(),melt_delim_chunked(),melt_tsv_chunked() (were inR/melt_delim_chunked.R)
• Replacement: Use the meltr package (https://cran.r-project.org/package=meltr)

✅read_table2() function

• Removed inRemove read_table2() #1605
• Before removal it wasdeprecate_soft("2.0.0", ...) then just called `read_table() anyway

✅quote_escape Parameter

• Removed inRemovequote_escape argument #1602
• Functions affected:
  • write_delim()
  • write_csv()
  • write_csv2()
  • write_excel_csv()
  • write_excel_csv2()
  • write_tsv()
• Behaviour before removal:lifecycle::deprecate_soft("2.0.0", ...) then assigning value to theescape parameter

✅quoted_na Parameter

• Hard deprecated in some settings inAdvance deprecation ofquoted_na argument #1604. Sort of a complicated situation.
• quoted_na appears in the signature of some core functions:
  • read_delim()
  • read_csv()
  • read_csv2()
  • read_tsv()
    Use ofquoted_na now errors unless user is explicitly using the 1st edition. It has beendeprecate_soft() since readr 2.0.0 and was just ignored.
• quoted_na is used in some functions that live entirely in readr and are arguably legacy:
  • read_*_chunked()
  • tokenizer_*()
    The documentation has been updated here to better reflect the situation (?).

✅skip_empty_rows parameter infwf_empty()

• Deprecation advanced in9713f73
• Use offwf_empty(skip_empty_rows =) now errors unless user is explicitly using the 1st edition. It has beendeprecate_soft() since readr 2.0.0 and was just ignored.
• skip_empty_rows arguments appear elsewhere (i.e. not justfwf_empty()) and are still used by first edition, so it's complicated.

Deprecated in readr 1.4.0 (2020-01-31)

✅path Parameter

• Removed inRemove the long deprecatedpath argument #1601
• Deprecated in favor of:file parameter
• Behavior before removal:lifecycle::deprecate_warn("1.4.0", ...) then assigning value tofile parameter
• Functions affected: 9 write functions:
  • write_delim()
  • write_csv()
  • write_csv2()
  • write_excel_csv()
  • write_excel_csv2()
  • write_tsv()
  • write_lines()
  • write_file()
  • write_rds()