mirror of
https://github.com/GothenburgBitFactory/taskwarrior.git
synced 2025-07-07 20:06:36 +02:00
Documentation Update
- Merged the (now obsolete) troubleshooting page into the FAQ page.
This commit is contained in:
Paul Beckingham
parent
99174d66b6
commit
262e42d42b
19 changed files with 67 additions and 176 deletions
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
@ -124,6 +124,53 @@
|
||||||
of the terminal window, and wraps accordingly.
|
of the terminal window, and wraps accordingly.
|
||||||
</p>
|
</p>
|
||||||
<hr>
|
<hr>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<b>
|
||||||
|
Q: How do I build task under Cygwin?
|
||||||
|
</b>
|
||||||
|
<br />
|
||||||
|
A: Task is built the same way everywhere. But under Cygwin, you'll
|
||||||
|
need to make sure you have the following packages available
|
||||||
|
first:
|
||||||
|
|
||||||
|
<ul>
|
||||||
|
<li>gcc
|
||||||
|
<li>make
|
||||||
|
<li>libncurses-devel
|
||||||
|
<li>libncurses8
|
||||||
|
</ul>
|
||||||
|
|
||||||
|
The gcc and make packages allow you to compile the code, and
|
||||||
|
are therefore required, but the ncurses packages are optional.
|
||||||
|
Ncurses will allow task to determine the width of the window, and
|
||||||
|
therefore use the whole width and wrap text accordingly, for a
|
||||||
|
more aesthetically pleasing display.
|
||||||
|
</p>
|
||||||
|
<hr>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<b>
|
||||||
|
Q: Do colors work under Cygwin?
|
||||||
|
</b>
|
||||||
|
<br />
|
||||||
|
A: They do, but only in a limited way. You can use regular
|
||||||
|
foreground colors (black, red, green ...) and you can
|
||||||
|
regular background colors (on_black, on_red, on_green ...),
|
||||||
|
but underline and bold are not supported.
|
||||||
|
<br />
|
||||||
|
<br />
|
||||||
|
If you run the command:
|
||||||
|
<code><pre>% task colors</pre></code>
|
||||||
|
Task will display all the colors it can use, and you will
|
||||||
|
see which ones you can use.
|
||||||
|
<br />
|
||||||
|
<br />
|
||||||
|
See the <a href="color.html">color</a> documentation for
|
||||||
|
more details on which colors can be used.
|
||||||
|
</p>
|
||||||
|
<hr>
|
||||||
|
|
||||||
<!--
|
<!--
|
||||||
<p>
|
<p>
|
||||||
<b>
|
<b>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
@ -53,7 +53,7 @@
|
||||||
<li><a href="usage.html">Task Command Usage</a>
|
<li><a href="usage.html">Task Command Usage</a>
|
||||||
<li><a href="recur.html">Recurring Tasks</a>
|
<li><a href="recur.html">Recurring Tasks</a>
|
||||||
<li><a href="date.html">Date Handling</a>
|
<li><a href="date.html">Date Handling</a>
|
||||||
<li><a href="troubleshooting.html">Troubleshooting</a>
|
<li><a href="faq.html">FAQ</a>
|
||||||
<li><a href="versions.html">Old Versions</a>
|
<li><a href="versions.html">Old Versions</a>
|
||||||
<li><a href="filter.html">Filters</a>
|
<li><a href="filter.html">Filters</a>
|
||||||
<li><a href="shadow.html">Shadow Files</a>
|
<li><a href="shadow.html">Shadow Files</a>
|
||||||
|
|
@ -169,7 +169,7 @@
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
<p>
|
<p>
|
||||||
Take a look at the <a href="troubleshooting.html">troubleshooting guide</a>
|
Take a look at the <a href="faq.html">FAQ</a>
|
||||||
for tips and workarounds to problems.
|
for tips and workarounds to problems.
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -1,156 +0,0 @@
|
||||||
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
|
||||||
<html xmlns="http://www.w3.org/1999/xhtml">
|
|
||||||
<head>
|
|
||||||
<title>Task Troubleshooting Guide</title>
|
|
||||||
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
|
|
||||||
<link rel="stylesheet" href="task.css" type="text/css" />
|
|
||||||
</head>
|
|
||||||
|
|
||||||
<body>
|
|
||||||
<div id="container">
|
|
||||||
<table>
|
|
||||||
<tr>
|
|
||||||
<td>
|
|
||||||
<div id="toolbar">
|
|
||||||
<a href="task.html">Home</a>
|
|
||||||
<a href="setup.html">Setup</a>
|
|
||||||
<a href="30second.html">30-second Tutorial</a>
|
|
||||||
<a href="simple.html">Simple</a>
|
|
||||||
<a href="advanced.html">Advanced</a>
|
|
||||||
<a href="shell.html">Shell</a>
|
|
||||||
<a href="config.html">Configuration</a>
|
|
||||||
<a href="color.html">Colors</a>
|
|
||||||
<a href="usage.html">Usage</a>
|
|
||||||
<a href="recur.html">Recurrence</a>
|
|
||||||
<a href="date.html">Date Handling</a>
|
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
|
||||||
<a href="versions.html">Old Versions</a>
|
|
||||||
<a href="links.html">Task on the Web</a>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div id="content">
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<h1 class="title">Task Troubleshooting Guide</h1>
|
|
||||||
<p>
|
|
||||||
Here you will find tips and suggestions for making task behave
|
|
||||||
properly, and bug workarounds.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<br />
|
|
||||||
<h2 class="title">Segmentation Fault for certain commands</h2>
|
|
||||||
<div class="content">
|
|
||||||
<p>
|
|
||||||
Upgrading task to version 1.1.0, 1.2.0 and 1.3.0 can cause
|
|
||||||
segmentation faults. This is mostly occurring for Ubuntu users,
|
|
||||||
although there is no reason for it to be limited to Ubuntu.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
Task 1.3.1 fixes this bug, but there is a workaround for users
|
|
||||||
of earlier versions. Add the following line to your ~/.taskrc
|
|
||||||
file:
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<code><pre>dateformat=m/d/Y</pre></code>
|
|
||||||
|
|
||||||
<p class="small">
|
|
||||||
The "dateformat" setting is supported in task 1.1.0 and later.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br />
|
|
||||||
<h2 class="title">How do I build task under Cygwin?</h2>
|
|
||||||
<div class="content">
|
|
||||||
<p>
|
|
||||||
Task is built the same way everywhere. But under Cygwin, you'll
|
|
||||||
need to make sure you have the following packages available
|
|
||||||
first:
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
<li>gcc
|
|
||||||
<li>make
|
|
||||||
<li>libncurses-devel
|
|
||||||
<li>libncurses8
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
The gcc and make packages allow you to compile the code, and
|
|
||||||
are therefore required, but the ncurses packages are optional.
|
|
||||||
Ncurses will allow task to determine the width of the window, and
|
|
||||||
therefore use the whole width and wrap text accordingly, for a
|
|
||||||
more aesthetically pleasing display.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br />
|
|
||||||
<h2 class="title">Do colors work under Cygwin?</h2>
|
|
||||||
<div class="content">
|
|
||||||
<p>
|
|
||||||
They do, but only in a limited way. You can use regular
|
|
||||||
foreground colors (black, red, green ...) and you can
|
|
||||||
regular background colors (on_black, on_red, on_green ...),
|
|
||||||
but underline and bold are not supported.
|
|
||||||
</p>
|
|
||||||
|
|
||||||
<p>
|
|
||||||
If you run the command:
|
|
||||||
<code><pre>% task colors</pre></code>
|
|
||||||
Task will display all the colors it can use, and you will
|
|
||||||
see which ones you can use.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<div class="content">
|
|
||||||
<p>
|
|
||||||
Copyright 2006-2009, P. Beckingham. All rights reserved.
|
|
||||||
</p>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
</td>
|
|
||||||
|
|
||||||
<td align="right" valign="top" width="200px">
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
<br />
|
|
||||||
|
|
||||||
<script type="text/javascript"><!--
|
|
||||||
google_ad_client = "pub-9709799404235424";
|
|
||||||
/* Task Main */
|
|
||||||
google_ad_slot = "8660617875";
|
|
||||||
google_ad_width = 120;
|
|
||||||
google_ad_height = 600;
|
|
||||||
//-->
|
|
||||||
</script>
|
|
||||||
<script type="text/javascript"
|
|
||||||
src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
|
|
||||||
</script>
|
|
||||||
</td>
|
|
||||||
</tr>
|
|
||||||
</table>
|
|
||||||
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<script type="text/javascript">
|
|
||||||
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
|
|
||||||
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
|
|
||||||
</script>
|
|
||||||
<script type="text/javascript">
|
|
||||||
var pageTracker = _gat._getTracker("UA-4737637-1");
|
|
||||||
pageTracker._initData();
|
|
||||||
pageTracker._trackPageview();
|
|
||||||
</script>
|
|
||||||
|
|
||||||
</body>
|
|
||||||
</html>
|
|
||||||
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
|
|
@ -23,7 +23,7 @@
|
||||||
<a href="usage.html">Usage</a>
|
<a href="usage.html">Usage</a>
|
||||||
<a href="recur.html">Recurrence</a>
|
<a href="recur.html">Recurrence</a>
|
||||||
<a href="date.html">Date Handling</a>
|
<a href="date.html">Date Handling</a>
|
||||||
<a href="troubleshooting.html">Troubleshooting</a>
|
<a href="faq.html">FAQ</a>
|
||||||
<a href="versions.html">Old Versions</a>
|
<a href="versions.html">Old Versions</a>
|
||||||
<a href="links.html">Task on the Web</a>
|
<a href="links.html">Task on the Web</a>
|
||||||
</div>
|
</div>
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue