Skip to content

Commit 3846bd9

Browse files
wouterjfabpot
authored andcommitted
Removed more references to third party docs
1 parent 1d468dd commit 3846bd9

File tree

7 files changed

+43
-45
lines changed

7 files changed

+43
-45
lines changed

.gitignore

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,2 @@
11
/_build
2-
/bundles/DoctrineFixturesBundle
3-
/bundles/DoctrineMigrationsBundle
4-
/bundles/DoctrineMongoDBBundle
5-
/bundles/SensioFrameworkExtraBundle
6-
/bundles/SensioGeneratorBundle
7-
/cmf
82
/_exts

book/controller.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -552,9 +552,7 @@ The Symfony templating engine is explained in great detail in the
552552
.. tip::
553553

554554
You can even avoid calling the ``render`` method by using the ``@Template``
555-
annotation. See the
556-
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/view>`
557-
more details.
555+
annotation. See the `FrameworkExtraBundle documentation`_ more details.
558556

559557
.. tip::
560558

@@ -826,3 +824,5 @@ Learn more from the Cookbook
826824

827825
* :doc:`/cookbook/controller/error_pages`
828826
* :doc:`/cookbook/controller/service`
827+
828+
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html

book/doctrine.rst

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ be.
2020
easy, and explained in the ":doc:`/cookbook/doctrine/dbal`" cookbook entry.
2121

2222
You can also persist data to `MongoDB`_ using Doctrine ODM library. For
23-
more information, read the ":doc:`/bundles/DoctrineMongoDBBundle/index`"
23+
more information, read the "`DoctrineMongoDBBundle`_"
2424
documentation.
2525

2626
A Simple Example: A Product
@@ -473,10 +473,10 @@ in your application. To do this, run:
473473
new column to the existing ``product`` table.
474474

475475
An even better way to take advantage of this functionality is via
476-
:doc:`migrations </bundles/DoctrineMigrationsBundle/index>`, which allow you to
477-
generate these SQL statements and store them in migration classes that
478-
can be run systematically on your production server in order to track
479-
and migrate your database schema safely and reliably.
476+
`migrations`_, which allow you to generate these SQL statements and store
477+
them in migration classes that can be run systematically on your production
478+
server in order to track and migrate your database schema safely and
479+
reliably.
480480

481481
Your database now has a fully-functional ``product`` table with columns that
482482
match the metadata you've specified.
@@ -562,7 +562,7 @@ an ``UPDATE`` query if the record already exists in the database.
562562

563563
Doctrine provides a library that allows you to programmatically load testing
564564
data into your project (i.e. "fixture data"). For information, see
565-
:doc:`/bundles/DoctrineFixturesBundle/index`.
565+
the "`DoctrineFixturesBundle`_" documentation.
566566

567567
Fetching Objects from the Database
568568
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -589,8 +589,7 @@ on its ``id`` value::
589589
.. tip::
590590

591591
You can achieve the equivalent of this without writing any code by using
592-
the ``@ParamConverter`` shortcut. See the
593-
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/converters>`
592+
the ``@ParamConverter`` shortcut. See the `FrameworkExtraBundle documentation`_
594593
for more details.
595594

596595
When you query for a particular type of object, you always use what's known
@@ -1084,7 +1083,7 @@ table, and ``product.category_id`` column, and new foreign key:
10841083

10851084
This task should only be really used during development. For a more robust
10861085
method of systematically updating your production database, read about
1087-
:doc:`Doctrine migrations </bundles/DoctrineMigrationsBundle/index>`.
1086+
`migrations`_.
10881087

10891088
Saving Related Entities
10901089
~~~~~~~~~~~~~~~~~~~~~~~
@@ -1400,8 +1399,8 @@ For more information about Doctrine, see the *Doctrine* section of the
14001399

14011400
* :doc:`/cookbook/doctrine/common_extensions`
14021401
* :doc:`/cookbook/doctrine/console`
1403-
* :doc:`/bundles/DoctrineFixturesBundle/index`
1404-
* :doc:`/bundles/DoctrineMongoDBBundle/index`
1402+
* :doc:`DoctrineFixturesBundle`
1403+
* :doc:`DoctrineMongoDBBundle`
14051404

14061405
.. _`Doctrine`: http://www.doctrine-project.org/
14071406
.. _`MongoDB`: http://www.mongodb.org/
@@ -1414,3 +1413,7 @@ For more information about Doctrine, see the *Doctrine* section of the
14141413
.. _`Lifecycle Events documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#lifecycle-events
14151414
.. _`Reserved SQL keywords documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
14161415
.. _`Persistent classes`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#persistent-classes
1416+
.. _`DoctrineMongoDBBundle`: http://symfony.com/doc/current/bundles/DoctrineMongoDBBundle/index.html
1417+
.. _`migrations`: http://symfony.com/doc/current/bundles/DoctrineMigrationsBundle/index.html
1418+
.. _`DoctrineFixturesBundle`: http://symfony.com/doc/current/bundles/DoctrineFixturesBundle/index.html
1419+
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html

book/routing.rst

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1070,8 +1070,7 @@ from the new routing resource.
10701070
.. tip::
10711071

10721072
You can also define routes using annotations. See the
1073-
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/routing>`
1074-
to see how.
1073+
`FrameworkExtraBundle documentation`_ to see how.
10751074

10761075
Adding a Host Requirement to Imported Routes
10771076
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -1298,3 +1297,4 @@ Learn more from the Cookbook
12981297
* :doc:`/cookbook/routing/scheme`
12991298

13001299
.. _`FOSJsRoutingBundle`: https://github.com/FriendsOfSymfony/FOSJsRoutingBundle
1300+
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/routing.html

components/http_kernel/introduction.rst

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -288,16 +288,15 @@ on the event object that's passed to listeners on this event.
288288
the Symfony Framework, and many deal with collecting profiler data when
289289
the profiler is enabled.
290290

291-
One interesting listener comes from the :doc:`SensioFrameworkExtraBundle </bundles/SensioFrameworkExtraBundle/index>`,
291+
One interesting listener comes from the `SensioFrameworkExtraBundle`_,
292292
which is packaged with the Symfony Standard Edition. This listener's
293-
:doc:`@ParamConverter </bundles/SensioFrameworkExtraBundle/annotations/converters>`
294-
functionality allows you to pass a full object (e.g. a ``Post`` object)
295-
to your controller instead of a scalar value (e.g. an ``id`` parameter
296-
that was on your route). The listener - ``ParamConverterListener`` - uses
297-
reflection to look at each of the arguments of the controller and tries
298-
to use different methods to convert those to objects, which are then
299-
stored in the ``attributes`` property of the ``Request`` object. Read the
300-
next section to see why this is important.
293+
`@ParamConverter`_ functionality allows you to pass a full object (e.g. a
294+
``Post`` object) to your controller instead of a scalar value (e.g. an
295+
``id`` parameter that was on your route). The listener -
296+
``ParamConverterListener`` - uses reflection to look at each of the
297+
arguments of the controller and tries to use different methods to convert
298+
those to objects, which are then stored in the ``attributes`` property of
299+
the ``Request`` object. Read the next section to see why this is important.
301300

302301
4) Getting the Controller Arguments
303302
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -395,14 +394,12 @@ return a ``Response``.
395394
.. sidebar:: ``kernel.view`` in the Symfony Framework
396395

397396
There is no default listener inside the Symfony Framework for the ``kernel.view``
398-
event. However, one core bundle -
399-
:doc:`SensioFrameworkExtraBundle </bundles/SensioFrameworkExtraBundle/index>` -
400-
*does* add a listener to this event. If your controller returns an array,
401-
and you place the :doc:`@Template </bundles/SensioFrameworkExtraBundle/annotations/view>`
402-
annotation above the controller, then this listener renders a template,
403-
passes the array you returned from your controller to that template,
404-
and creates a ``Response`` containing the returned content from that
405-
template.
397+
event. However, one core bundle - `SensioFrameworkExtraBundle`_ - *does*
398+
add a listener to this event. If your controller returns an array,
399+
and you place the `@Template`_ annotation above the controller, then this
400+
listener renders a template, passes the array you returned from your
401+
controller to that template, and creates a ``Response`` containing the
402+
returned content from that template.
406403

407404
Additionally, a popular community bundle `FOSRestBundle`_ implements
408405
a listener on this event which aims to give you a robust view layer
@@ -689,3 +686,6 @@ look like this::
689686
.. _reflection: http://php.net/manual/en/book.reflection.php
690687
.. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
691688
.. _`Create your own framework... on top of the Symfony2 Components`: http://fabien.potencier.org/article/50/create-your-own-framework-on-top-of-the-symfony2-components-part-1
689+
.. _`SensioFrameworkExtraBundle`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
690+
.. _`@ParamConverter`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
691+
.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view.html

cookbook/controller/service.rst

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -132,9 +132,8 @@ the route ``_controller`` value:
132132
.. tip::
133133

134134
You can also use annotations to configure routing using a controller
135-
defined as a service. See the
136-
:doc:`FrameworkExtraBundle documentation </bundles/SensioFrameworkExtraBundle/annotations/routing>`
137-
for details.
135+
defined as a service. See the `FrameworkExtraBundle documentation`_ for
136+
details.
138137

139138
Alternatives to base Controller Methods
140139
---------------------------------------
@@ -267,3 +266,4 @@ inject *only* the exact service(s) that you need directly into the controller.
267266

268267
.. _`Controller class source code`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
269268
.. _`base Controller class`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php
269+
.. _`FrameworkExtraBundle documentation`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/routing.html

cookbook/templating/PHP.rst

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -60,11 +60,10 @@ below renders the ``index.html.php`` template::
6060
);
6161
}
6262

63-
You can also use the :doc:`/bundles/SensioFrameworkExtraBundle/annotations/view`
64-
shortcut to render the default ``AcmeHelloBundle:Hello:index.html.php`` template::
63+
You can also use the `@Template`_ shortcut to render the default
64+
``AcmeHelloBundle:Hello:index.html.php`` template::
6565

6666
// src/Acme/HelloBundle/Controller/HelloController.php
67-
6867
use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
6968

7069
// ...
@@ -326,3 +325,5 @@ within an HTML context. The second argument lets you change the context. For
326325
instance, to output something in a JavaScript script, use the ``js`` context::
327326

328327
<?php echo $view->escape($var, 'js') ?>
328+
329+
.. _`@Template`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/view`

0 commit comments

Comments
 (0)