forked from nus-cs2103-AY2324S2/tp
-
Notifications
You must be signed in to change notification settings - Fork 5
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
30 additions
and
38 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -14,11 +14,11 @@ AddressBook Level 3 (AB3) is a **desktop app for managing contacts, optimized fo | |
|
||
1. Ensure you have Java `11` or above installed in your Computer. | ||
|
||
1. Download the latest `addressbook.jar` from [here](https://github.com/se-edu/addressbook-level3/releases). | ||
1. Download the latest `TeachStack.jar` from [here](https://github.com/se-edu/addressbook-level3/releases). | ||
|
||
1. Copy the file to the folder you want to use as the _home folder_ for your AddressBook. | ||
|
||
1. Open a command terminal, `cd` into the folder you put the jar file in, and use the `java -jar addressbook.jar` command to run the application.<br> | ||
1. Open a command terminal, `cd` into the folder you put the jar file in, and use the `java -jar TeachStack.jar` command to run the application.<br> | ||
A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data.<br> | ||
 | ||
|
||
|
@@ -51,11 +51,7 @@ AddressBook Level 3 (AB3) is a **desktop app for managing contacts, optimized fo | |
* Items in square brackets are optional.<br> | ||
e.g `n/NAME [t/TAG]` can be used as `n/John Doe t/friend` or as `n/John Doe`. | ||
|
||
* Items with `…` after them can be used multiple times including zero times.<br> | ||
e.g. `[t/TAG]…` can be used as ` ` (i.e. 0 times), `t/friend`, `t/friend t/family` etc. | ||
|
||
* Parameters can be in any order.<br> | ||
e.g. if the command specifies `n/NAME p/PHONE_NUMBER`, `p/PHONE_NUMBER n/NAME` is also acceptable. | ||
* Parameters must be in specified order.<br> | ||
|
||
* Extraneous parameters for commands that do not take in parameters (such as `help`, `list`, `exit` and `clear`) will be ignored.<br> | ||
e.g. if the command specifies `help 123`, it will be interpreted as `help`. | ||
|
@@ -74,40 +70,37 @@ Format: `help` | |
|
||
### Adding a person: `add` | ||
|
||
Adds a person to the address book. | ||
Adds student details to the address book. | ||
|
||
Format: `add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/TAG]…` | ||
Format: `add id/STUDENT_ID n/NAME e/EMAIL g/GRADE [t/TAG]` | ||
|
||
<div markdown="span" class="alert alert-primary">:bulb: **Tip:** | ||
A person can have any number of tags (including 0) | ||
</div> | ||
* Name, student_id, grade, and email must have. | ||
* Name can be case-insensitive, eg. john doe, JOHN DOE same as John Doe | ||
* Email must have the correct format and string length of 8 for the email username eg. [email protected] | ||
* Grade: [A+, A, A-, B+, B, B-, C+, C, D+, D, F] | ||
* Student_id must start with A and end with a letter, string length of 9 eg. A0000000X | ||
|
||
Examples: | ||
* `add n/John Doe p/98765432 e/[email protected] a/John street, block 123, #01-01` | ||
* `add n/Betsy Crowe t/friend e/[email protected] a/Newgate Prison p/1234567 t/criminal` | ||
|
||
### Listing all persons : `list` | ||
* `add id/A01234567H n/John Doe e/[email protected]` | ||
|
||
Shows a list of all persons in the address book. | ||
|
||
Format: `list` | ||
|
||
### Editing a person : `edit` | ||
|
||
Edits an existing person in the address book. | ||
|
||
Format: `edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [a/ADDRESS] [t/TAG]…` | ||
Format: `edit [id/STUDENT_ID] [e/EMAIL] ` | ||
|
||
* Edits the person at the specified `INDEX`. The index refers to the index number shown in the displayed person list. The index **must be a positive integer** 1, 2, 3, … | ||
* At least one of the optional fields must be provided. | ||
* Existing values will be updated to the input values. | ||
* When editing tags, the existing tags of the person will be removed i.e adding of tags is not cumulative. | ||
* You can remove all the person’s tags by typing `t/` without | ||
specifying any tags after it. | ||
* Edits the person with the specified `STUDENT_ID`. The STUDENT_ID refers to the unique alphanumeric sequence assigned to a person shown in the displayed person list. The student_id **must be 9 digits long | ||
* Only 1 field may be provided. | ||
* Existing value will be updated to the input value. | ||
* Name can be case-insensitive, eg. john doe, JOHN DOE same as John Doe | ||
* Email must have the correct domain (@u.nus.edu) and string length of 8 for the email username eg. [email protected] | ||
* Grade may be of values: [A+, A, A-, B+, B, B-, C+, C, D+, D, F] | ||
|
||
Examples: | ||
* `edit 1 p/91234567 e/[email protected]` Edits the phone number and email address of the 1st person to be `91234567` and `[email protected]` respectively. | ||
* `edit 2 n/Betsy Crower t/` Edits the name of the 2nd person to be `Betsy Crower` and clears all existing tags. | ||
* `edit id/A0123456X e/[email protected]` Edits the email address of the person with student_id = A0123456X to be `[email protected]`. | ||
* `edit id/A2233445X n/Betsy Crower` Edits the name of the person with student_id = A2233445X to be `Betsy Crower`. | ||
|
||
|
||
### Locating persons by name: `find` | ||
|
||
|
@@ -187,12 +180,10 @@ _Details coming soon ..._ | |
|
||
## Command summary | ||
|
||
Action | Format, Examples | ||
--------|------------------ | ||
**Add** | `add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/TAG]…` <br> e.g., `add n/James Ho p/22224444 e/[email protected] a/123, Clementi Rd, 1234665 t/friend t/colleague` | ||
**Clear** | `clear` | ||
**Delete** | `delete INDEX`<br> e.g., `delete 3` | ||
**Edit** | `edit INDEX [n/NAME] [p/PHONE_NUMBER] [e/EMAIL] [a/ADDRESS] [t/TAG]…`<br> e.g.,`edit 2 n/James Lee e/[email protected]` | ||
**Find** | `find KEYWORD [MORE_KEYWORDS]`<br> e.g., `find James Jake` | ||
**List** | `list` | ||
**Help** | `help` | ||
| Action | Format, Examples | | ||
|------------|--------------------------------------------------------------------------------------------------------------------------| | ||
| **Add** | `add id/STUDENT_ID n/NAME e/EMAIL g/GRADE [t/TAG]` <br> e.g., `add id/A01234567X n/James Ho e/[email protected] g/B+` | | ||
| **Delete** | `delete id/STUDENT_ID`<br> e.g., `delete A01234567X` | | ||
| **Edit** | `edit id/STUDENT_ID [g/GRADE] `<br> e.g.,`edit A0123466C g/A+` | | ||
| **View** | `view id/STUDENT_ID`<br> e.g., `find A0123466D` | | ||
| **Group** | `group id/STUDENT_ID_1 [id/STUDENT_ID_2] …` <br> e.g., `group A1234567R, A2345678R` | |