Skip to content

Commit 15852b4

Browse files
committed
Improve the base project.
Signed-off-by: Ritho <[email protected]>
1 parent 6610ac7 commit 15852b4

12 files changed

+61
-102
lines changed

CONTRIBUTE

+51-22
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Contribute to XXXXXX project
1+
Contribute to XXXXXXX project
22
===============================
33

44
There are six main ways to contribute to this project. The first one
@@ -55,7 +55,7 @@ When you run the tests you can see the results and errors generated
5555
both in the screen and in a file generated in the tests directory.
5656

5757
To report a bug please visit the project page at github
58-
(https://github.com/i02sopop/XXXXXX), click on the Issues section and
58+
(https://github.com/i02sopop/snag), click on the Issues section and
5959
add a new issue. Please, be as descriptive as possible with all the
6060
information you can and add an email address to contact with you if
6161
needed.
@@ -76,36 +76,65 @@ proposal and we find the way to make the donation.
7676
Translators
7777
=============
7878

79-
TODO
79+
The original language of the project is english, and it have a
80+
translation into spanish. The translations are managed with gettext,
81+
so if you want to enhace a translation or add a new one you should
82+
check the po subdirectory. In that directory you can find one po file
83+
per language, so you can edit the file for the language you'ree interested
84+
in and make the needed changes.
85+
86+
If you want to start a translation to a new language you can copy one
87+
of the po files (the language you're translating from) to a new po file
88+
and start the translation.
89+
90+
For small changes you can do directly a PR with your changes, but if you
91+
want to do deeper changes it's better to add a new task to github and
92+
asign it to you.
93+
94+
For now we have not consider the case of having several people that want to
95+
do a translation to the same language, but if we reach that case we will
96+
design one lead translator (to decide between all) to coordinate the work.
8097

8198
Documenters
8299
=============
83100

84-
TODO
101+
Documentation, both technical and user oriented, is a really important part
102+
of the project. Apart from the documentation at the code, we have documentation
103+
both in the docs subdirectory and in the github wiki, so feel free to contribute
104+
to any of the places.
105+
106+
If you are going to document more than some few lines be sure to have a task
107+
opened in github and assign it to yourself before start the work to avoid
108+
doing the same work by two different people.
109+
110+
When documenting, try to be clear, concise and with a same style on all the
111+
text, and, if you are not sure about something in particular, please ask
112+
any question to [email protected].
85113

86114
Administrators
87115
================
88116

89-
The project needs administrators to update the website, maintain the
90-
email lists, ... In the github issues page you can find some tasks to
117+
The project needs administrators to update the website, create and maintain
118+
the email lists, ... In the github issues page you can find some tasks to
91119
do by the administrators sorted by difficulty and priority. If you want
92-
to do any of the tasks please keep in touch with the rest of
93-
administrators (ask at <[email protected]>
94-
for them) or write to <[email protected]> in order to coordinate the
95-
tasks.
120+
to do any of the tasks write to <[email protected]> and assign yourself
121+
the issue in order to be coordinated.
96122

97123
Developers
98124
============
99125

100-
XXXXXX is handled in a git repository that you can find in the
101-
github's project page at https://github.com/i02sopop/XXXXXX.
102-
There is a developer mailing list at [email protected]
103-
and a mailing list for the commits at [email protected],
104-
and you can subscribe and access to them at https://lists.ritho.net.
105-
106-
If you want to start collaborating with the project you can check the
107-
issues category in the github page to see the bugs opened about the
108-
project.
109-
110-
TODO: Include information about the directory structure at the
111-
repository.
126+
Snag is handled in a git repository that you can find in the github's
127+
project page at https://github.com/i02sopop/snag. In github we manage
128+
all the functionalities, bugs, tasks and so on, so if you want to
129+
collaborate adding new tasks or doing some of them you should go
130+
the github's issues to read if the task is already planned or if
131+
someone is doing already the task.
132+
133+
When the time comes, we'll create a list for developers, users, bugs,
134+
commits, ..., but if you want to collaborate in the project write
135+
[email protected] to coordinate the work.
136+
137+
The source code is in the src directory, and the header files are in
138+
the include directory. You have also some documentation in the docs
139+
directory, so feel free to start digging in those directories to learn
140+
about the code and start making changes.

ChangeLog

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
XXXXXX 0.0.1
22

3-
2016-02-17 Pablo Alvarez de Sotomayor Posadillo <[email protected]>
3+
2024-03-29 Pablo Alvarez de Sotomayor Posadillo <[email protected]>
44
* First release of XXXXXX.

INSTALL

+1-4
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
Installation of XXXXXX
22
============================
3-
Copyright (C) 2016 XXXXXX project (ses AUTHORS.en)
3+
Copyright (C) 2024 XXXXXX project (ses AUTHORS.en)
44

55
This file is free documentation; the XXXXXX project gives unlimited
66
permission to copy, distribute and modify it.
@@ -246,6 +246,3 @@ use the application.
246246

247247
`configure' also accepts some other, not widely useful, options.
248248
Run `configure --help' for more details.
249-
250-
First steps
251-
==============

bootstrap

+1-1
Original file line numberDiff line numberDiff line change
@@ -24,5 +24,5 @@ fi
2424

2525
echo
2626
echo "Now run configure with your desired options, for instance:"
27-
echo " ./configure CFLAGS=-g"
27+
echo " ./configure --prefix=/usr/local CFLAGS=-g"
2828
echo

configure.ac

+1-1
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ AC_CHECK_LIB([m], [sqrt], [LIBMATH=-lm], [AC_MSG_ERROR([Math library not found])
2525
AC_SUBST([LIBMATH])
2626
PKG_CHECK_MODULES([CHECK], [check >= 0.10.0])
2727

28-
dnl Checking headers
28+
dnl Checking headers
2929
AC_CHECK_HEADERS([stdlib.h])
3030
AC_CHECK_HEADERS([string.h])
3131
AC_CHECK_HEADER_STDBOOL

include/definitions.h

-36
This file was deleted.

include/functions.h

-22
This file was deleted.

include/macros.h

+2-2
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
/*********************************************************************************
2-
* Copyright (c) 2016 XXXXXX project (see AUTHORS) *
2+
* Copyright (c) 2024 XXXXXX project (see AUTHORS) *
33
* *
44
* This file is part of XXXXXX. *
55
* *
@@ -13,7 +13,7 @@
1313
* A PARTICULAR PURPOSE. See the GNU General Public License for more details. *
1414
* *
1515
* You should have received a copy of the GNU General Public License along with *
16-
* coconet. If not, see <http://www.gnu.org/licenses/>. *
16+
* XXXXXXX. If not, see <http://www.gnu.org/licenses/>. *
1717
********************************************************************************/
1818

1919
#ifndef MACROS_H

po/LINGUAS

+1
Original file line numberDiff line numberDiff line change
@@ -1 +1,2 @@
11
es
2+
en

src/Makefile.am

+1-2
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,7 @@ c_project_CFLAGS=-I$(INCLUDE_DIR) -DLOCALEDIR=\"$(localedir)\"
88
c_project_LDADD=$(LIBMATH) $(LIBINTL)
99
c_project_LDFLAG=
1010
c_project_SOURCES=main.c
11-
c_project_HEADERS=$(INCLUDE_DIR)/definitions.h $(INCLUDE_DIR)/functions.h \
12-
$(INCLUDE_DIR)/gettext.h $(INCLUDE_DIR)/macros.h
11+
c_project_HEADERS=$(INCLUDE_DIR)/gettext.h $(INCLUDE_DIR)/macros.h
1312

1413
.PHONY: check-syntax
1514
check-syntax:

src/main.c

+2-10
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
/*********************************************************************************
2-
* Copyright (c) 2016 XXXXXX project (see AUTHORS) *
2+
* Copyright (c) 2024 XXXXXX project (see AUTHORS) *
33
* *
44
* This file is part of XXXXXX. *
55
* *
@@ -13,18 +13,10 @@
1313
* A PARTICULAR PURPOSE. See the GNU General Public License for more details. *
1414
* *
1515
* You should have received a copy of the GNU General Public License along with *
16-
* coconet. If not, see <http://www.gnu.org/licenses/>. *
16+
* XXXXXXX. If not, see <http://www.gnu.org/licenses/>. *
1717
********************************************************************************/
1818

1919
#include <string.h>
20-
#include <definitions.h>
21-
22-
/*********************************************************************************
23-
* Manage the program flow. *
24-
* @param int argc: Number of arguments of the program. *
25-
* @param char** argv: Arguments passed to the program. *
26-
* @returns 0 with no errors and -1 otherwise. *
27-
********************************************************************************/
2820

2921
int
3022
main(int argc, char **argv) {

tests/test.c

-1
Original file line numberDiff line numberDiff line change
@@ -9,4 +9,3 @@ int
99
main() {
1010
return 0;
1111
}
12-

0 commit comments

Comments
 (0)